API Reference

The Clerk Backend API is organized around REST and is built to be used from your backend code. All requests accept JSON-encoded (recommended) and form-encoded request bodies, return JSON-encoded responses and uses standard HTTP response codes, authentication, and verbs.
Base URL: https://api.clerk.dev/


The Clerk Backend API uses secret API keys. You can find and create your instance API keys in Clerk Dashboard API Keys -> Backend API Keys page.
These keys should never be shared with anyone, as they allow the holder to access all your Clerk resources.
An example request is the following:
curl \
-H "Authorization: Bearer test_abc...xyz" \
-H "Content-type: application/json" \
Be careful not to expose these keys in your Git repository, frontend code, or anywhere else that is public.

Rate limiting

All API requests are subject to a default limit of 50 requests per 10 seconds. Certain endpoints might be subject to different limits, in which case their limits are documented in the endpoint's respective documentation page.
Exceeding the rate limits will result in 429 Too Many Requests HTTP responses. In that case, the Retry-After header includes the amount of seconds until the block expires.