> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dfns.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bulk Wallet Job

> Retrieve a single bulk wallet creation job by its ID, with progress and status.



## OpenAPI

````yaml /openapi.yaml get /wallets/bulk-create/{jobId}
openapi: 3.1.0
info:
  version: 2.0.15
  title: Dfns
servers:
  - url: https://api.dfns.io
    description: Default - Europe
  - url: https://api.uae.dfns.io
    description: UAE
  - url: https://api.dfns.ninja
    description: <Deprecated> Staging
security: []
paths:
  /wallets/bulk-create/{jobId}:
    get:
      tags:
        - Wallets
      summary: Get Bulk Wallet Job
      description: >-
        Retrieve a single bulk wallet creation job by its ID, with progress and
        status.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^bwc-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
            description: The bulk wallet creation job to retrieve.
          required: true
          description: The bulk wallet creation job to retrieve.
          name: jobId
          in: path
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkWalletCreationJob'
      security:
        - authenticationToken: []
components:
  schemas:
    BulkWalletCreationJob:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^bwc-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
          description: ID of the bulk wallet creation job.
          example: bwc-7jk0a-j19vv-4fhcj3452jceonu0
        orgId:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^or-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
          description: ID of the org that owns the job.
          example: or-30tnh-itmjs-s235s5ontr3r23h2
        status:
          type: string
          enum:
            - Pending
            - InProgress
            - Completed
            - PartiallyCompleted
            - Failed
          description: Bulk wallet creation job status.
        network:
          allOf:
            - $ref: '#/components/schemas/Network'
            - description: Network the wallets are created on.
        namePrefix:
          type: string
          description: >-
            Name prefix shared by every wallet in the batch; wallet at index N
            is named `${namePrefix}${N}`.
        tags:
          type: array
          items:
            type: string
            pattern: ^[a-zA-Z0-9_.:/+-]{1,100}$
            description: Wallet Tag.
          maxItems: 10
          description: List of tags.
        totalCount:
          type: integer
          description: Total number of wallets requested in the batch.
        completedCount:
          type: integer
          description: Number of wallets created so far.
        keystoreId:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^store-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
          description: Key store the batch keys are minted in.
          example: store-425nf-ebf0a-qq22t6qra51tj8j0
        masterKeyId:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^key-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
          description: Master key the batch wallets are derived from.
          example: key-01snl-t56gb-j8tsok0vn802p80i
        reason:
          type: string
          description: Failure reason, set when the job did not complete fully.
        nextRetryDate:
          type: string
          description: >-
            [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date string when
            the job is next retried.
          example: '2023-04-14T20:41:28.715Z'
        nextRetryAttempt:
          type: integer
          description: Number of retry attempts made so far.
        dateCreated:
          type: string
          description: >-
            [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date string when
            the job was created.
          example: '2023-04-14T20:41:28.715Z'
        dateUpdated:
          type: string
          description: >-
            [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date string when
            the job was last updated.
          example: '2023-04-14T20:41:28.715Z'
        dateCompleted:
          type: string
          description: >-
            [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date string when
            the job finished.
          example: '2023-04-14T20:41:28.715Z'
      required:
        - id
        - orgId
        - status
        - network
        - namePrefix
        - tags
        - totalCount
        - completedCount
        - keystoreId
        - dateCreated
        - dateUpdated
      example:
        id: bwc-1f04s-lqc9q-xxxxxxxxxxxxxxxx
        orgId: or-1f04s-lqc9q-xxxxxxxxxxxxxxxx
        status: InProgress
        network: Ethereum
        namePrefix: user-
        tags: []
        totalCount: 500000
        completedCount: 12000
        keystoreId: ks-1f04s-lqc9q-xxxxxxxxxxxxxxxx
        dateCreated: '2023-04-14T20:41:28.715Z'
        dateUpdated: '2023-04-14T20:41:28.715Z'
    Network:
      type: string
      title: Network
      enum:
        - Algorand
        - AlgorandTestnet
        - Aptos
        - AptosTestnet
        - ArbitrumOne
        - ArbitrumSepolia
        - ArcTestnet
        - AvalancheC
        - AvalancheCFuji
        - BabylonGenesis
        - BabylonTestnet5
        - Base
        - BaseSepolia
        - Berachain
        - BerachainBepolia
        - Bitcoin
        - BitcoinSignet
        - BitcoinTestnet4
        - BitcoinCash
        - Bob
        - BobSepolia
        - Bsc
        - BscTestnet
        - Canton
        - CantonTestnet
        - Cardano
        - CardanoPreprod
        - Concordium
        - ConcordiumTestnet
        - Celo
        - CeloAlfajores
        - Codex
        - CodexSepolia
        - CosmosHub4
        - CosmosIcsTestnet
        - Dogecoin
        - DogecoinTestnet
        - Ethereum
        - EthereumClassic
        - EthereumClassicMordor
        - EthereumSepolia
        - EthereumHoodi
        - FlareC
        - FlareCCoston2
        - FlowEvm
        - FlowEvmTestnet
        - Hedera
        - HederaTestnet
        - Ink
        - InkSepolia
        - InternetComputer
        - Ion
        - IonTestnet
        - Iota
        - IotaTestnet
        - Kusama
        - KusamaAssetHub
        - Litecoin
        - LitecoinTestnet
        - Movement
        - MovementTestnet
        - Near
        - NearTestnet
        - Optimism
        - OptimismSepolia
        - Origyn
        - Plasma
        - PlasmaTestnet
        - Plume
        - PlumeSepolia
        - Paseo
        - PaseoAssetHub
        - Polkadot
        - PolkadotAssetHub
        - Polygon
        - PolygonAmoy
        - Polymesh
        - PolymeshTestnet
        - Race
        - RaceSepolia
        - Rayls
        - RaylsTestnet
        - Robinhood
        - RobinhoodSepolia
        - SeiAtlantic2
        - SeiPacific1
        - Solana
        - SolanaDevnet
        - Sonic
        - SonicTestnet
        - Starknet
        - StarknetSepolia
        - Stellar
        - StellarTestnet
        - Sui
        - SuiTestnet
        - Tezos
        - TezosGhostnet
        - TezosShadownet
        - Tempo
        - TempoModerato
        - Tsc
        - TscTestnet1
        - Ton
        - TonTestnet
        - Tron
        - TronNile
        - Westend
        - WestendAssetHub
        - Xdc
        - XdcApothem
        - XLayer
        - XLayerSepolia
        - XrpLedger
        - XrpLedgerTestnet
  securitySchemes:
    authenticationToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        **Bearer Token:** Used to authenticate API requests.

        More details how to generate the token: [Authentication
        flows](https://docs.dfns.co/api-reference/auth/login-flows)

````