List Batch Jobs - Crustdata Docs

List batch jobs for the authenticated account

curl --request GET \
  --url https://api.crustdata.com/batch \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crustdata.com/batch"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.crustdata.com/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "jobs": [
    {
      "batch_id": "48b676de-f0d1-4ae5-af52-4e021991efe6",
      "status": "completed",
      "entity": "person",
      "action": "search",
      "identifier_count": 1,
      "result_count": 6,
      "entities_requested": 1,
      "entities_fulfilled": 6,
      "created_at": "2026-06-12T12:02:00.220799+00:00",
      "completed_at": "2026-06-12T12:02:01.816021+00:00"
    },
    {
      "batch_id": "afb80886-2f90-45f9-a2c7-db407e227ca8",
      "status": "completed",
      "entity": "company_v2024",
      "action": "enrich",
      "identifier_count": 2,
      "result_count": 2,
      "entities_requested": 2,
      "entities_fulfilled": 2,
      "created_at": "2026-03-05T01:06:43.941233+00:00",
      "completed_at": "2026-03-05T01:06:44.904341+00:00"
    }
  ],
  "next_cursor": "afb80886-2f90-45f9-a2c7-db407e227ca8",
  "has_more": true
}

GET

https://api.crustdata.com

batch

List batch jobs for the authenticated account

curl --request GET \
  --url https://api.crustdata.com/batch \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.crustdata.com/batch"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.crustdata.com/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "jobs": [
    {
      "batch_id": "48b676de-f0d1-4ae5-af52-4e021991efe6",
      "status": "completed",
      "entity": "person",
      "action": "search",
      "identifier_count": 1,
      "result_count": 6,
      "entities_requested": 1,
      "entities_fulfilled": 6,
      "created_at": "2026-06-12T12:02:00.220799+00:00",
      "completed_at": "2026-06-12T12:02:01.816021+00:00"
    },
    {
      "batch_id": "afb80886-2f90-45f9-a2c7-db407e227ca8",
      "status": "completed",
      "entity": "company_v2024",
      "action": "enrich",
      "identifier_count": 2,
      "result_count": 2,
      "entities_requested": 2,
      "entities_fulfilled": 2,
      "created_at": "2026-03-05T01:06:43.941233+00:00",
      "completed_at": "2026-03-05T01:06:44.904341+00:00"
    }
  ],
  "next_cursor": "afb80886-2f90-45f9-a2c7-db407e227ca8",
  "has_more": true
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Query Parameters

limit

integer

default:20

Maximum number of jobs to return per page. Values outside 1-100 are clamped into range.

Required range: 1 <= x <= 100

Example:

2

status

enum<string>

Return only jobs in this status. Any other value returns 400.

Available options:

pending,

processing,

completed,

failed

Example:

"completed"

cursor

string<uuid>

The next_cursor value from the previous page (the batch ID of that page's last job). Omit on the first page.

Example:

"afb80886-2f90-45f9-a2c7-db407e227ca8"

Response

Paginated list of batch jobs

Paginated list of batch jobs for the authenticated account, most recent first.

jobs

object[]

required

Batch jobs on this page.

Show child attributes

next_cursor

string<uuid> | null

required

Batch ID to pass as cursor for the next page, or null when there are no more pages.

Example:

"afb80886-2f90-45f9-a2c7-db407e227ca8"

has_more

boolean

required

Whether more jobs exist after this page.

Example:

true