> ## 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.

# List Bulk Wallet Jobs

> List the org bulk wallet creation jobs, most recent first, with progress and status.



## OpenAPI

````yaml /openapi.yaml get /wallets/bulk-create
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:
    get:
      tags:
        - Wallets
      summary: List Bulk Wallet Jobs
      description: >-
        List the org bulk wallet creation jobs, most recent first, with progress
        and status.
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 50
            description: Maximum number of items to return.
          required: false
          description: Maximum number of items to return.
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            description: >-
              Opaque token used to retrieve the next page. Returned as
              `nextPageToken` from the previous request.
          required: false
          description: >-
            Opaque token used to retrieve the next page. Returned as
            `nextPageToken` from the previous request.
          name: paginationToken
          in: query
        - schema:
            type: string
            enum:
              - Pending
              - InProgress
              - Completed
              - PartiallyCompleted
              - Failed
            description: Filter jobs by status.
          required: false
          description: Filter jobs by status.
          name: status
          in: query
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/BulkWalletCreationJob'
                    description: Current page items.
                  nextPageToken:
                    type: string
                    description: >-
                      token to use as `paginationToken` to request the next
                      page.
                required:
                  - items
      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)

````