---
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}`

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' — The chain name
  - `tokens_count` integer, nullable — Number of tokens exported

## Other responses

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

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/revisions/17c41f337b2e/schema)