List states
Owners can list connector states. A state is holding progress of background process.
Sign in to run requests against the CDE API.
Authorization
oAuth2AuthCode AuthorizationBearer <token>
In: header
Path Parameters
publicId*string
Format
uuidconnectorVersion*string
Major version number as an integer
- For 1.0.5 use
1 - For 2.5.6 use
2
You can also use latest for the latest version, or main for the currently main released version.
Match
^main|latest|\d+$Query Parameters
from?integer
starting item
limit?integer
items per page
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/connectors/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/string/states"{
"data": [
{
"id": "91d6f2f9-eb04-4144-9475-dec9054a4e48",
"status": "failed",
"name": "ipsum",
"owner": "7b39bff5-f523-47d4-878a-18a7a6fe74ce",
"created": "2026-05-28T14:01:28+02:00",
"config": {
"name": "state 5",
"connectorPublicId": "019e6e76-03b7-7f1e-a15d-3e79f9b0636b",
"majorVersion": 2
},
"data": []
},
{
"id": "ccf9fd2a-951b-4522-a67f-6831af2c40f3",
"status": "done",
"name": "numquam",
"owner": "1b31db5f-3ea6-417f-ac6d-b150023c1098",
"created": "2026-05-28T14:01:28+02:00",
"config": {
"name": "state 4",
"connectorPublicId": "019e6e76-03b7-7f1e-a15d-3e79f9b0636b",
"majorVersion": 2
},
"data": []
}
],
"metadata": {
"from": 0,
"limit": 20,
"count": 2,
"total": 2,
"next": null
},
"message": "successful operation",
"resource": "state"
}{
"message": "You have to be authorized to access this resource."
}{
"message": "Access denied for user."
}{
"message": "Connector not found."
}How is this guide?