The Clerk.io Developer Hub

Welcome to the Clerk.io developer hub.

This is site is only technical specification for developers.

You'll find comprehensive guides and documentation to help you start working with Clerk.io at our Help Center

Get Started    

Basics

Introduction to the Clerk.io API.

The Clerk.io API is a REST-like API where both GET and POST can be used to send requests.

Each request should contain an API version, the endpoint, and, optionally, the arguments for that endpoint.

The version is always v2 and should be the first part of the URL path. The endpoint is the remainder of the URL path. The arguments are either sent as query parameters for GET requests, or as a JSON encoded object for POST requests.

For complex query parameters in GETrequests (lists, objects etc), the parameter value should be JSON encoded or else it will be treated as a string.

The response from the API is always a JSON encoded data-structure.

curl http://api.clerk.io/v2/some/endpoint?arg1=bar&arg2=42

{
    "status": "ok"
}
curl -X POST \
     -H 'Content-Type: application/json' \
     -d '{"arg1":"bar",
          "arg2": 42
         }' \
     http://api.clerk.io/v2/some/endpoint

{
    "status": "ok"
}

See all avaliable API endpoints avaliable in our API Reference.