Productsup
CDE APIApi referenceStates

List states

Integrators can only list their own states. A state is holding progress of background process.

Sign in to run requests against the CDE API.
GET
/states

Authorization

oAuth2AuthCode
AuthorizationBearer <token>

In: header

Query Parameters

triggered_by?string

filter by user who triggered the background process

status?string

Filter state by current status (pending,done,failed)

from?integer

starting item

limit?integer

items per page

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/states"
{
  "data": [
    {
      "id": "1f824b04-dd13-4517-9689-56d64d5e969a",
      "status": "pending",
      "name": "voluptas",
      "owner": "019e6e76-4c1c-7dd2-9e55-8de733060b90",
      "created": "2026-05-28T14:01:47+02:00",
      "config": {
        "name": "state 3"
      },
      "data": []
    },
    {
      "id": "b33fdd2f-d865-4873-bfd5-5757afa93d88",
      "status": "done",
      "name": "commodi",
      "owner": "019e6e76-4c1c-7dd2-9e55-8de733060b90",
      "created": "2026-05-28T14:01:47+02:00",
      "config": {
        "name": "state 4"
      },
      "data": []
    }
  ],
  "metadata": {
    "from": 0,
    "limit": 100,
    "count": 2,
    "total": 2,
    "next": null
  },
  "message": "successful operation",
  "resource": "state"
}
{
  "message": "Invalid connector user identifier.",
  "errors": []
}
{
  "message": "You have to be authorized to access this resource."
}
{
  "message": "Access denied for user."
}

How is this guide?