Swapcard · Rate Limits

Swapcard Rate Limits

Swapcard's Content API applies a cost-based (query-complexity) rate limit rather than a simple requests-per-minute cap. Each request is assigned a point cost and accounts are limited by points consumed per minute. Additional structural guards cap query depth, aliases, tokens, directives, and request body size. Values below are documented on the Content API Limitations page; the Leads API documents its own limits separately (verify on its Limitations page).

Swapcard Rate Limits is the machine-readable rate-limit profile for Swapcard on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 7 rate-limit definitions, measuring points, levels, aliases, tokens, and directives.

The profile also includes 3 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Events, GraphQL, Rate Limiting, and Quotas.

7 Limits Throttle: 429
EventsGraphQLRate LimitingQuotas

Limits

Points Per Minute account
points · minute
60000
Cost-based budget across all queries/mutations in a rolling minute.
Max Points Per Query request
points
10000
A single query/mutation may not exceed 10,000 points of complexity.
Max Nesting Depth request
levels
20
Up to 20 levels of nested objects per query.
Max Aliases request
aliases
50
Up to 50 aliases per query.
Max Tokens request
tokens
2000
Combined fields, arguments, and aliases capped at 2,000 tokens.
Max Directives request
directives
20
Up to 20 directives per query.
Max Request Body Size request
bytes
1048576
Request body may not exceed 1 megabyte.

Policies

Cost-Based Budgeting
Requests consume a point budget (mutations 1000, objects 2, scalars 1, depth factor 1.5x); throttling triggers when the per-minute budget is exhausted.
Dynamic Adjustment
Swapcard may temporarily lower limits for an individual user to guarantee service and prevent abuse, without advance notification.
Backoff Strategy
Clients should implement exponential backoff with jitter and honor 429 responses; keep queries shallow and request only needed fields to stay within the point budget.

Sources