The Clerk.io Developer Hub

Welcome to the Clerk.io developer hub. You'll find comprehensive guides and documentation to help you start working with Clerk.io as quickly as possible, as well as support if you get stuck. Let's jump right in!

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"
}

Basics

Introduction to the Clerk.io API.