---
title: "Get Job Status"
method: GET
path: "/v0/token/bulk-export/jobs/{job_id}"
tags: ["Token"]
---

# Get Job Status

`GET /v0/token/bulk-export/jobs/{job_id}`

## Request

- Base URL: `https://api.blockaid.io`
- URL: `https://api.blockaid.io/v0/token/bulk-export/jobs/{job_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-CLIENT-ID`
- TypeScript: <https://skmtc.dev/blockaid-official/apis/blockaid-api/docs/v0/token/bulk-export/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the current status of the job and download URLs when status is `succeeded`.

## Path parameters

- `job_id` string, required: The ID of an export job you already created.

## Response `200`

Job status retrieved successfully

- BulkExportJobStatusResponse
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required: Current state of the job: `queued` (accepted, waiting to start), `running` (in progress), `succeeded` (completed successfully), `failed` (completed with an error).
  - `files` string[], nullable
  - `expires_in` integer, nullable: Seconds until URLs expire
  - `chain` 'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'zora' | 'solana' | 'starknet' | 'starknet-sepolia' | 'stellar' | 'linea' | 'degen' | 'zksync' | 'scroll' | 'blast' | 'soneium-minato' | 'base-sepolia' | 'bitcoin' | 'abstract' | 'soneium' | 'ink' | 'berachain' | 'unichain' | 'ronin' | 'sui' | 'hedera' | 'hyperevm' | 'xlayer' | 'monad' | 'megaeth' | 'tempo' | 'sei' | 'kaia' | 'tron' | 'robinhood' | 'flare' | 'arc': The chain name
  - `tokens_count` integer, nullable: Number of tokens exported

## Other responses

- `404`: Job not found
- `422`: Validation Error

## Changes

> 120 revisions in range; 1 not diffed.

- **2026-10-08** `421a1aca41d2`: 1 warning
  - added the new `arc` enum value to the `chain/anyOf[subschema #1: TokenScanSupportedChains]/` response property for the response status `200`
- **2026-10-08** `5f40f1064bf0`: 1 info
  - removed the `arc` enum value from the `chain/anyOf[subschema #1: TokenScanSupportedChains]/` response property for the response status `200`
- **2026-09-23** `cb12d1ef42f6`: 1 warning
  - added the new `arc` enum value to the `chain/anyOf[subschema #1: TokenScanSupportedChains]/` response property for the response status `200`
- **2026-08-03** `7897dd82aeda`: 1 warning
  - added the new `flare` enum value to the `chain/anyOf[subschema #1: TokenScanSupportedChains]/` response property for the response status `200`
- **2026-07-13** `5dd76e537ede`: 1 warning
  - added the new `robinhood` enum value to the `chain/anyOf[subschema #1: TokenScanSupportedChains]/` response property for the response status `200`

[Operation history](https://skmtc.dev/blockaid-official/apis/blockaid-api/changes/v0/token/bulk-export/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/blockaid-official/apis/blockaid-api.md) - [All operations](https://skmtc.dev/blockaid-official/apis/blockaid-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blockaid-official/apis/blockaid-api/revisions/104550c9d3f1?raw)