Public API

COPE’s public REST API lets vendor integrations manage released COPE resources from a COPE business workspace using JSON over HTTPS.

Contract

Contract	Behavior
Base URL	`https://api.cope.com`
Encoding	JSON over HTTPS
Authentication	`Authorization: Bearer <token>` on every request
Errors	RFC 9457 `application/problem+json` (`type`, `title`, `status`, `code`, `errors[]`)
Pagination	Cursor pagination by default. Offset pagination is legacy compatibility only when an operation documents `page` and `per_page`.
Versioning	Major version in the URL (`/v1/...`). Breaking changes require a new major.
Compatibility	Additive response fields and new optional request params may happen within the same major.

Authenticate with a live COPE API key (ck_live_*; keys issued earlier as cope_sk_live_* keep working). A key is scoped to one business, so no business header is needed. Dashboard sign-in tokens are not accepted. Test-mode public API keys are reserved but not accepted yet; they currently return 401 invalid_token until the public sandbox is enabled.

API Areas

Area	Path prefix	Use it for
Commerce	`/v1/commerce/*`	Offers, products, and commerce integration workflows.

Treat 4xx responses as permanent for the same payload - do not retry the request as-is, fix the input and resend. Treat 5xx responses as transient and retry with backoff.

AI agents and MCP

MCP server for your store (cope-mcp): let Claude, Cursor or another MCP client read your store with your API key. On npm as cope-mcp.
MCP for AI shopping agents (cope-sdk/mcp): let a buyer’s AI agent build a cart in your store and hand the buyer a checkout link. Ships in cope-sdk.

​Public API

​Contract

​API Areas

​AI agents and MCP

Public API

Contract

API Areas

AI agents and MCP