Skip to main content
GET
/
orchestration
/
batches
/
list
List batches
curl --request GET \
  --url https://api.getcargo.io/v1/orchestration/batches/list \
  --header 'Authorization: Bearer <token>'
{
  "batches": [
    {
      "uuid": "<string>",
      "workspaceUuid": "<string>",
      "workflowUuid": "<string>",
      "releaseUuid": "<string>",
      "nodes": [
        {
          "uuid": "<string>",
          "slug": "<string>",
          "config": {},
          "childrenUuids": [
            "<string>"
          ],
          "fallbackOnFailure": true,
          "position": {
            "x": 123,
            "y": 123
          },
          "kind": "native",
          "actionSlug": "<string>",
          "name": "<string>",
          "description": "<string>",
          "retry": {
            "maximumAttempts": 123,
            "initialInterval": 123,
            "backoffCoefficient": 123
          },
          "fallbackChildUuid": "<string>"
        }
      ],
      "temporalWorkflowId": "<string>",
      "data": {
        "kind": "<string>",
        "segmentUuid": "<string>"
      },
      "errorMessage": "<string>",
      "status": "pending",
      "runsStatus": "healthy",
      "runsCount": 123,
      "executedRunsCount": 123,
      "failedRunsCount": 123,
      "creditsUsedCount": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "finishedAt": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
uuids
string[]

Batch identifiers to include.

​
workflowUuids
string[]

Workflow identifiers to include.

​
releaseUuid
string

Release identifier to filter by.

​
parentBatchUuid
string

Parent batch identifier.

​
parentRunUuid
string

Parent run identifier.

​
parentNodeUuid
string

Parent node identifier.

​
statuses
enum<string>[]

Batch statuses to include.

Available options:
pending,
syncing,
skipped,
querying,
running,
success,
error,
cancelling,
cancelled
​
hasRuns
enum<string>

Filter batches that have runs.

Available options:
true,
false
​
isSkipped
enum<string>

Filter batches by skipped state.

Available options:
true,
false
​
isFinished
enum<string>

Filter batches by finished state.

Available options:
true,
false
​
includedDataKinds
enum<string>[]

Data kinds to include.

Available options:
segment,
change,
filter,
recordIds,
records,
file,
runs,
group,
schedule,
form
​
excludedDataKinds
enum<string>[]

Data kinds to exclude.

Available options:
segment,
change,
filter,
recordIds,
records,
file,
runs,
group,
schedule,
form
​
limit
string

Maximum number of batches to return.

​
offset
string

Number of batches to skip.

Response

Successful response

​
batches
Batches · object[]
required

List of batches.