Skip to main content
GET
/
files
List files
curl --request GET \
  --url https://api.demo.cula.earth/tracking/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>'
{
  "data": [
    {
      "id": "fil_01kqzcjrpyf27tgeaqk8twgw91",
      "file_name": "puro_LCA_RCCS_Q4.xlsm",
      "file_size_bytes": 2451230,
      "mime_type": "application/vnd.ms-excel.sheet.macroEnabled.12",
      "site": {
        "id": "<string>",
        "external_id": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "starting_after": "<string>",
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>"
  }
}

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 files.

​
data
object[]
required
​
pagination
object
required

Cursor-based pagination metadata.