---
title: "Get bulk registration jobs"
method: GET
path: "/key_link/signing_keys/bulk/jobs"
tags: ["Key Link"]
---

# Get bulk registration jobs

`GET /key_link/signing_keys/bulk/jobs`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/key_link/signing_keys/bulk/jobs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/key_link/signing_keys/bulk/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the workspace's bulk registration jobs, newest first, a page at a time.

## Query parameters

- `pageCursor` string
- `pageSize` integer

## Response `200`

Bulk registration jobs for the workspace

- GetBulkSigningKeysJobsResponse
  - `data` BulkSigningKeyJob[], required: Registration jobs for the workspace, newest first.
    - `jobId` string, required: Id of the registration job.
    - `status` 'QUEUED' | 'IN_PROGRESS' | 'COMPLETED' | 'INCOMPLETE' | 'FAILED', required: QUEUED means the job is waiting for another bulk registration to finish, since only a limited number run at once. IN_PROGRESS means it is running. COMPLETED means every submitted key is present in the workspace. FAILED means the request was refused before any key was registered, so `reason` has to be acted on before resubmitting is worth anything. INCOMPLETE means some keys are not registered; resubmitting the same request retries exactly those, and `reason` says whether that is likely to help -- keys not registered because of a transient failure will succeed, a key whose certificate or proof was rejected will be rejected again.
    - `total` number, required: Keys in the submitted request.
    - `created` number, required: Keys registered by this job.
    - `alreadyRegistered` number, required: Keys already present in the workspace, recognized and skipped.
    - `failed` number, required: Keys rejected. See `reason`.
    - `reason` string, nullable: Free text describing what went wrong. Null while the job is healthy.
    - `fileHash` string, nullable: Hex digest over the submitted keys. Two jobs sharing a digest were the same set of keys, which makes a sequence of resubmissions recognizable.
    - `createdAt` number, required: Creation date (timestamp) in milliseconds.
    - `updatedAt` number, required: Last progress update (timestamp) in milliseconds.
  - `next` string: Cursor to the next page. Absent on the last page.

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)