Quickstart

Authenticate and fetch your first data from the Cula Tracking API. Every request goes to the base URL https://api.demo.cula.earth/tracking/v1.

Set your credentials

As part of the beta program you receive a client_id and client_secret, along with the IDs (org_...) of the organisations you can access. Export them for the commands below:

export CULA_CLIENT_ID="your-client-id"
export CULA_CLIENT_SECRET="your-client-secret"
export CULA_ORGANISATION_ID="your-organisation-id"

Get an access token

The API uses the OAuth2 client credentials flow. Exchange your credentials for a short-lived access token at the token endpoint:

Token request

curl -X POST https://auth.demo.cula.earth/oauth2/token \
  -u "$CULA_CLIENT_ID:$CULA_CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "audience=com.cula.tracking"

Token response

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 300,
  "token_type": "bearer"
}

Export the returned access_token so the next request can use it:

export CULA_ACCESS_TOKEN="eyJhbGciOiJSUzI1NiIs..."

See Authentication for the full token lifecycle, organisation context, and access model.

Make your first request

Every request needs the access token as a bearer token plus a Cula-Organisation-Id header. Fetch the organisations you have access to:

Request

curl https://api.demo.cula.earth/tracking/v1/organisations \
  -H "Authorization: Bearer $CULA_ACCESS_TOKEN" \
  -H "Cula-Organisation-Id: $CULA_ORGANISATION_ID"

Response

{
  "data": [
    {
      "id": "org_01k6cvp6bdeayb0hfrghfwxjzy",
      "name": "Pyrolysis GmbH",
      "address": "Business Street 1, 10115 Berlin, DE",
      "external_id": null,
      "managed_by_site": null
    }
  ],
  "pagination": {
    "starting_after": null,
    "limit": 10,
    "has_more": false,
    "next_cursor": null
  }
}

Next Steps

Now that you’ve authenticated and retrieved accessible organisations, you can:

List sinks to access carbon removal data: GET /sinks
Get sink details including tracking steps: GET /sinks/{id}
List sites involved in carbon removal activities: GET /sites
Set up webhooks to receive real-time notifications: POST /webhooks

See Receiving Event Updates to start consuming webhook events.

Get Started

Guides

Next Steps

​Next Steps

Next Steps