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

# Get a collection

> One collection by id.



## OpenAPI

````yaml /v2/openapi.json get /collections/{id}
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/{id}:
    get:
      summary: Get a collection
      description: One collection by id.
      parameters:
        - schema:
            type: string
            description: The collection id.
          required: true
          description: The collection id.
          name: id
          in: path
        - $ref: '#/components/parameters/HermesOrg'
      responses:
        '200':
          description: The collection.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Collection'
        '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: No collection with this id in your organization.
          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:
    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
    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
  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.