Core Concepts

The conventions every v3 endpoint shares.

Every endpoint in the JOIN API follows the same conventions for request and response shape, pagination, errors, rate limits and versioning. Once your integration handles them for one resource, it handles them for all.

PageCovers
Requests and responsesThe data envelope, status codes, partial updates, and formats for dates, countries and currencies.
PaginationPaging through lists with limit and cursor, and syncing changes with updatedAfter.
ErrorsThe error envelope, every error code, and which errors to retry.
Rate limitsThe per-token limits, the headers that report them, and handling 429.
Versioning and deprecationWhat may change within v3, and how deprecations are announced.
LocalizationTranslating display names with the language parameter.