# Bulk Creation Report

A bulk creation, its counts, and each of its accounts in the order of the request.

## Overview

- The job as [List Bulk Creations](https://docs.aureahub.com/docs/accounts-bulk-list.md) shows it, plus `items`: `index` (its place in the request, from 0), `customerRefId`, `status` and `accountId` and `reason`.
- `created`: `accountId` the account made. `skipped`: your tenant already had the `customerRefId` — `reason` `ACCOUNT_REF_EXISTS`, `accountId` the account that holds it. `failed`: `reason` the code that refused it — `ACCOUNT_USER_UNKNOWN`, a wallet path's code such as `WALLET_KEY_STORE_UNAVAILABLE`, `ACCOUNT_WALLET_AMBIGUOUS`… `pending`: not done yet.
- Narrow with `status`; page with `limit` (1–1000, default 100) and `after`, the previous page's `nextAfter` (`null` on the last page).
- `404` `ACCOUNTS_BULK_NOT_FOUND` (`No such bulk creation here.`) for a job that is not your tenant's. Same readers as [List Accounts](https://docs.aureahub.com/docs/accounts-list.md).

## Endpoint

### `GET /v1/accounts/bulk/{jobId}`

Authentication: bearer token required.

A bulk creation's report.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `jobId` | string (uuid) | yes | The `jobId` Create in Bulk answered |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | `pending`, `created`, `skipped` or `failed` |
| `after` | integer | no | The previous page's `nextAfter` |
| `limit` | integer | no | 1–1000, default 100 |

**Responses**

`200` OK

```json
{
  "id": "c41e8a7d-3b2f-4d96-a05e-9f7b1c3d5e82",
  "status": "completed",
  "total": 2,
  "counts": { "pending": 0, "created": 1, "skipped": 1, "failed": 0 },
  "wallets": [
    { "chain": "evm", "isTestnet": false },
    { "chain": "solana", "isTestnet": false }
  ],
  "requestedBy": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
  "createdAt": "2026-10-07T10:00:00.120Z",
  "startedAt": "2026-10-07T10:00:05.004Z",
  "finishedAt": "2026-10-07T10:00:07.881Z",
  "items": [
    { "index": 0, "customerRefId": "cust-00043", "status": "created", "accountId": "6e2b9d14-7a3c-4f85-b1d0-8c4e2a6f9b37", "reason": null },
    { "index": 1, "customerRefId": "cust-00044", "status": "skipped", "accountId": "1f7c3a95-2d8e-4b6a-9e04-5b3d7f1a2c68", "reason": "ACCOUNT_REF_EXISTS" }
  ],
  "nextAfter": null
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such bulk creation here.",
  "details": { "code": "ACCOUNTS_BULK_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#accounts-bulk-get