Claude Platform Docs

Get Plugin Marketplace

$ ant beta:organization:plugin-marketplaces retrieve
GET/v1/organizations/plugin_marketplaces/{marketplace_id}

Retrieve a plugin marketplace by ID.

Accepted credentials: an Admin API key with the read:plugins or read:org_audit scope, or a Compliance Access Key with the read:compliance_org_data scope.

Every request must include the beta header anthropic-beta: ce-plugins-2026-09-01. A request without it returns 404, exactly as if the endpoint did not exist. The Plugins API is in beta and is available to Claude Enterprise organizations only. It is not available to Claude Platform (Claude Console) organizations, or to organizations with HIPAA readiness enabled.

Parameters
--marketplace-id: string⁠Path parameter

ID of the plugin marketplace (prefixed marketplace_).

--organization-id: optional string⁠Query parameter

For a read:org_audit or read:compliance_org_data key created for all of a parent organization's linked organizations: a child organization of that parent to read instead of the organization the key was created in, given as the organization's UUID or its org_-prefixed ID. A value that is neither returns a 400; an organization that is not a child of the key's parent, or where the Plugins API is not available, returns a 404. Any other key may pass only its own organization's ID here; another organization returns a 404.

--beta: optional array of AnthropicBeta⁠Header parameter

This endpoint is in beta: requests must send ce-plugins-2026-09-01 in this header.

Returns
beta_plugin_marketplace: object{ type: "plugin_marketplace", id, created_at, 7 more }
type: "plugin_marketplace"

Always plugin_marketplace.

id: string

The plugin marketplace's ID, prefixed marketplace_.

created_at: string

RFC 3339.

formatdate-time
default_installation_preference: "auto_install" or "available" or "not_available" or "required"

Organization plugin marketplace: the organization-wide setting every Plugin in it with no setting of its own gets. Null for a member's personal plugin marketplace. One of required, auto_install, available, not_available; a value this API does not yet name is returned as stored.

One of the following:
"auto_install"
"available"
"not_available"
"required"
last_sync_ended_at: string

RFC 3339. When the most recent synchronization attempt to finish did so, whatever its outcome; for a repository plugin marketplace no synchronization has run on yet, when it was created. Null for a plugin marketplace that is not synchronized from a repository.

formatdate-time
last_sync_read_sha: string

The commit the last synchronization attempt that reached the repository read, whether or not its content was then accepted (see sync_status); an attempt that ends failed_auth or failed_transient leaves it unchanged. Null until an attempt has first read the repository, and for a plugin marketplace that is not synchronized from a repository.

name: string

Fixed for the plugin marketplace's lifetime.

owner: BetaPluginOwnerOrganization or BetaPluginOwnerUser

The organization, or the member whose personal plugin marketplace it is.

One of the following:
beta_plugin_owner_organization: object{ type: "organization" }
type: "organization"

The Plugin lives in a plugin marketplace the organization owns.

beta_plugin_owner_user: object{ type: "user", user_id }
type: "user"

The Plugin lives in one member's personal plugin marketplace.

user_id: string

The member's User ID.

source: "directory" or "github" or "gitlab" or 2 more

Where the plugin marketplace's Plugins come from: manual when they are uploaded; github, gitlab or public_git when they are synchronized from the Git repository the owner connected, into which nothing can be uploaded; directory is Anthropic's own catalog, which this API does not list. A value this API does not yet name is returned as stored.

One of the following:
"directory"
"github"
"gitlab"
"manual"
"public_git"
sync_status: "failed_auth" or "failed_content" or "failed_limits" or 3 more

Outcome of the plugin marketplace's most recent synchronization: one of success, in_progress, failed_content, failed_transient, failed_auth, failed_limits; a value this API does not yet name is returned as stored. Null until a synchronization is first attempted — so always for a manual plugin marketplace.

One of the following:
"failed_auth"
"failed_content"
"failed_limits"
"failed_transient"
"in_progress"
"success"
Get Plugin Marketplace
ant beta:organization:plugin-marketplaces retrieve \
  --api-key my-anthropic-api-key \
  --marketplace-id marketplace_id
Returns Examples
Response 200
{
  "id": "marketplace_01HxQ3v9KpZ2mTn8RwLc4Ys7",
  "created_at": "2026-03-14T09:26:53.589793Z",
  "default_installation_preference": "available",
  "last_sync_ended_at": "2026-03-14T09:26:53.589793Z",
  "last_sync_read_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
  "name": "engineering-tools",
  "owner": {
    "type": "organization"
  },
  "source": "github",
  "sync_status": "success",
  "type": "plugin_marketplace"
}