Skip to main content
GET
cURL
Returns the published credit prices as a complete list of credit_price items. Any valid API key can call this endpoint, and the call consumes no credits. Each item contains id, name, group, credits, unit, min_plan, status, and endpoints (each with method and path). Units are per_request, per_page, per_record, per_item, per_screen, per_mark_per_day, or per_watch_per_day. Paths use OpenAPI parameter syntax, such as /v1/trademarks/{id}; wildcard patterns expand to concrete operations. Status is available, beta, planned, or internal. Authorized keys see internal actions with their internal status preserved. Each endpoint includes required_scope when its effective scope differs from the default trademarks:read (for example, screening:read, portfolios:manage, or events:read). Endpoints that accept alternative scopes publish required_scope: null and required_scope_any_of, listing the accepted alternatives. Endpoints that accept any authenticated key, including keys with no scopes, instead publish required_scope: null and any_authenticated: true, without required_scope_any_of. The alternative-scope case includes feedback and office-vote operations, which accept any canonical or supported legacy key scope. The row-level required_scope appears only when every published endpoint shares the same non-default scope. Meeting min_plan alone does not grant access. Admin keys also satisfy the scope requirement. The top-level schedule_version identifies the pricing version used by billing events. Both REST and MCP always include the boolean degraded: false when the OpenAPI document builds successfully, or true when endpoints use normalized fixture paths after a document-build failure. has_more is always false and pagination.cursor is null. Prices contain no currency amounts; see plans and packs. Beta actions show nominal prices but consume no credits during beta. Planned prices do not imply availability. Daily monitoring prices apply to the daily meter, separately from management API requests. endpoints lists the operations published in this deployment; it may be empty for daily meters and for actions whose routes are not yet enabled. Identify daily meters by unit (per_mark_per_day or per_watch_per_day), not by an empty array. If the OpenAPI document cannot be built, normalized fixture paths are returned for that request with Cache-Control: private, no-store; the next request retries the document build. Watch-management operations cost 0 credits per request; their OpenAPI price has charged_per_request: false and a separate daily price block. Successful document builds containing only public prices use Cache-Control: public, max-age=300. Scope-restricted prices are included only for authorized keys and use private caching. Responses vary by Authorization.
MCP clients can use the unbilled get_credit_pricing tool after authentication with a key that passes the MCP transport gate: one of read, search, trademarks:read, billing:read, portfolios:manage, or admin (the legacy search:read scope is also accepted). The tool adds no further scope requirement. REST accepts any valid key, including one with no scopes. For the actual debit on a metered call, read X-Credits-Charged; see credit headers. For your balance, use Get Credits.

Authorizations

Authorization
string
header
required

API key (sig_ prefix)

Response

Credit prices by API action

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
enum<boolean>
required
Available options:
false
pagination
object
required
schedule_version
integer
required
degraded
boolean
required

True when the OpenAPI document could not be built and endpoints use normalized fixture paths. The next request retries the build.

request_id
string