Skip to main content
GET
/
materials
List materials
curl --request GET \
  --url https://api.demo.cula.earth/tracking/v1/materials \
  --header 'Authorization: Bearer <token>' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>'
{
  "data": [
    {
      "id": "mat_01kqzcjrpyf27tge9dnvsqv8t2",
      "name": "Corn (No.2 Yellow Dent)",
      "type": "biomass"
    },
    {
      "id": "mat_01kqzcjrpyf27tge9mg18vyhr2",
      "name": "Liquified CO2 (captured, biogenic)",
      "type": "liquified_co2"
    },
    {
      "id": "mat_01kqzcjrpyf27tge9yx2x8y28z",
      "name": "Biochar (woodchip pyrolysis)",
      "type": "biochar"
    }
  ],
  "pagination": {
    "starting_after": null,
    "limit": 10,
    "has_more": false,
    "next_cursor": null
  }
}

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Exchange your client_id and client_secret for a short-lived access token, then pass it as a Bearer token in the Authorization header.

Headers

​
Cula-Organisation-Id
string
required

Organisation ID that scopes this request. The authenticated consumer must be authorized for this organisation. Omitting this header returns 400; passing an unauthorised org returns 403.

Query Parameters

​
starting_after
string

Cursor for forward pagination. Pass the next_cursor value from a previous response to fetch the next page. Must be a valid resource ID.

​
limit
integer
default:10

Maximum number of items to return per page.

Required range: 1 <= x <= 50

Response

Paginated list of materials.

​
data
object[]
required
​
pagination
object
required

Cursor-based pagination metadata.