Getting Started

Obtain an access token

Exchange your client credentials for a bearer access token:

Code
curl -X POST https://api.kordiam.app/api/v2/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "grant_type": "client_credentials"
  }'

The response contains your access token:

Code
{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "api.read api.write",
  "refresh_token": "dGhpcyBpcyBh..."
}

Make your first API call

Use the access token in the Authorization header:

Code
ACCESS_TOKEN="eyJhbGciOi..."

curl https://api.kordiam.app/api/v2/elements \
  -H "Authorization: Bearer $ACCESS_TOKEN"

This first request returns a paginated element list. Follow nextCursor from the response to walk additional pages. The response shape and available query parameters are documented in the API reference, and shared pagination patterns are covered in Querying Lists.