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

# List collections

> Money that landed on your balance — bank and paybill pay-ins to your virtual accounts and stablecoin transfers to your deposit addresses — newest first. `amount` is what was credited: there is no separate fee line. Filter with `asset`; pass `next_before_id` back as `before_id` for the next page.



## OpenAPI

````yaml /v2/openapi.json get /collections
openapi: 3.1.0
info:
  title: Jenzy Hermes Multi-asset API
  version: 2.0.0
  description: >-
    Hold and pay out across the assets enabled for your organization. Every
    amount is an exact decimal string beside an `asset` field. Authenticate with
    the same `jz_live_…` API key as `/v1`.
servers:
  - url: https://api.jenzy.com/v2
    description: Production
security: []
paths:
  /collections:
    get:
      summary: List collections
      description: >-
        Money that landed on your balance — bank and paybill pay-ins to your
        virtual accounts and stablecoin transfers to your deposit addresses —
        newest first. `amount` is what was credited: there is no separate fee
        line. Filter with `asset`; pass `next_before_id` back as `before_id` for
        the next page.
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 200
            description: Page size, 1-200 (default 50).
          required: false
          description: Page size, 1-200 (default 50).
          name: limit
          in: query
        - schema:
            type: string
            format: uuid
            description: 'Keyset cursor: the `next_before_id` from the previous page.'
          required: false
          description: 'Keyset cursor: the `next_before_id` from the previous page.'
          name: before_id
          in: query
        - schema:
            type: string
            minLength: 1
            description: >-
              An asset code as `GET /v2/assets` lists it — uppercase, never
              compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
              live on the payment object.
            example: USDC
          required: false
          description: >-
            An asset code as `GET /v2/assets` lists it — uppercase, never
            compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
            live on the payment object.
          name: asset
          in: query
        - $ref: '#/components/parameters/HermesOrg'
      responses:
        '200':
          description: One page of collections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionList'
        '400':
          description: Malformed `limit` or `before_id`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Missing, malformed, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: >-
            Organization suspended, request IP not on the allowlist, or no
            multi-asset access yet (`onboarding_incomplete` /
            `access_suspended`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: >-
            `asset` names an asset that is not enabled for your organization and
            holds no money for you.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: The `/v2` shutter is closed — check `GET /v2/ping`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - ApiKeyAuth: []
components:
  parameters:
    HermesOrg:
      name: HERMES-ORG
      in: header
      required: false
      description: >-
        The id of one of your Child orgs. The call then acts on that Child org,
        not on your organization. If you do not send it, the call acts on your
        organization. An id that is not one of your Child orgs gives `404`.
      schema:
        type: string
        format: uuid
        example: 3f1c2a9e-8b7d-4e21-9a6f-0c5d4b3e2a10
  schemas:
    CollectionList:
      type: object
      properties:
        collections:
          type: array
          items:
            $ref: '#/components/schemas/Collection'
        has_more:
          type: boolean
        next_before_id:
          type:
            - string
            - 'null'
          format: uuid
      required:
        - collections
        - has_more
        - next_before_id
    ErrorEnvelope:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - validation_error
                - unauthorized
                - forbidden
                - not_found
                - conflict
                - rate_limited
                - internal_error
                - unknown_institution
                - invalid_mobile_number
                - invalid_account_number
                - mobile_number_institution_mismatch
                - service_unavailable
                - sandbox_only
                - insufficient_funds
                - rail_disabled
                - amount_limit_exceeded
                - org_limit_exceeded
                - service_incident
                - service_maintenance
                - onboarding_incomplete
                - access_suspended
                - corridor_not_enabled
                - unsupported_pair
                - invalid_wallet_address
                - rate_unavailable
                - quote_expired
                - quote_used
                - limit_exceeded
                - amount_below_minimum
                - unsupported_asset
                - unsupported_network
                - unsupported_media_type
                - payload_too_large
                - client_ref_used
                - beneficiary_required
                - beneficiary_not_allowed
                - proof_not_expected
                - invalid_beneficiary
                - beneficiary_exists
                - beneficiary_not_active
                - invoice_required
                - prohibited_industry
              description: >-
                Stable identifier a client may branch on — never renamed or
                removed.
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
    Collection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The collection id.
        asset:
          type: string
          minLength: 1
          description: >-
            An asset code as `GET /v2/assets` lists it — uppercase, never
            compound (`USDC`, `USD`; never `USDC-ETHEREUM`). Network and rail
            live on the payment object.
          example: USDC
        amount:
          type: string
          description: >-
            What landed: the amount credited to your balance in this asset, as
            an exact decimal string. This is the one money figure a collection
            carries — there is no separate fee line.
          example: '993.00'
        status:
          type: string
          enum:
            - settled
            - reversed
          description: >-
            `settled` — credited to your balance. `reversed` — the payer’s bank
            or the network clawed the money back after it was credited; your
            balance is corrected by Jenzy.
        source:
          oneOf:
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - bank
                virtual_account_id:
                  type:
                    - string
                    - 'null'
                  description: >-
                    The `id` of the virtual account of yours (`GET
                    /v2/virtual-accounts`) the money landed on. Bank pay-ins
                    carry no payer identity: this tells you where it landed, not
                    who sent it.
                  example: b7c9d1e2-3f4a-4b5c-8d6e-7f8a9b0c1d2e
                amount:
                  type: string
                  description: >-
                    Only on a USD collection: the USD amount that the virtual
                    account received, as an exact decimal string. The collection
                    `amount` is the USDC that your balance received.
                  example: '10000.00'
                asset:
                  type: string
                  minLength: 1
                  description: >-
                    Only on a USD collection: the asset of `source.amount`,
                    `USD`.
                  example: USD
              required:
                - type
                - virtual_account_id
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - wallet
                network:
                  type:
                    - string
                    - 'null'
                  description: >-
                    The network the transfer arrived on, by name (`ethereum`,
                    `solana`). Null while unresolved.
                  example: ethereum
                address:
                  type:
                    - string
                    - 'null'
                  description: Your deposit address the transfer landed on.
                  example: '0x52908400098527886E0F7030069857D2E4169EE7'
              required:
                - type
                - network
                - address
            - type: object
              properties:
                type:
                  type: string
                  enum:
                    - payout_refund
                payout_id:
                  type: string
                  format: uuid
                  description: >-
                    The `id` of the failed USD payout that this money came back
                    from.
              required:
                - type
                - payout_id
          description: Where the money came in — the mirror of a payout’s `destination`.
        created_at:
          type: string
          format: date-time
      required:
        - id
        - asset
        - amount
        - status
        - source
        - created_at
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: 'Your Jenzy API key: `Authorization: Bearer jz_live_…`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.