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

# List Deposits

> Retrieves a list of deposits for the authenticated user for a specific asset type. Asset can be 'brl', 'usd', 'usdc' or 'usdt'



## OpenAPI

````yaml GET /api/v0/assets/{asset}/deposits
openapi: 3.1.0
info:
  title: Crown API & Webhooks
  version: 1.0.0
  description: >-
    Open API 3 docs for Crown API


    Webhook events that Crown will POST to your configured endpoint URL. All
    webhooks expect a 200 OK response. Payloads use kebab-case for all keys to
    match the Crown API conventions.
servers:
  - url: https://app.crown-brlv.com
    description: Production server
security: []
paths:
  /api/v0/assets/{asset}/deposits:
    get:
      summary: List deposits by asset
      description: >-
        Retrieves a list of deposits for the authenticated user for a specific
        asset type. Asset can be 'brl', 'usd', 'usdc' or 'usdt'
      parameters:
        - in: path
          name: asset
          required: true
          schema:
            type: string
            enum:
              - usdc
              - usdt
              - brl
              - brly
              - usd
              - brlv
              - wbrly
      responses:
        '200':
          description: Deposits list retrieved successfully
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      deposits:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Unique identifier for the BRL deposit
                              example: 660e8400-e29b-41d4-a716-446655440001
                            type:
                              type: string
                              enum:
                                - token
                                - pix
                                - manual-fx
                              description: Type of deposit
                              example: pix
                            amount:
                              type: string
                              format: decimal
                              description: Amount of the deposit in BRL
                              example: '100.50'
                            status:
                              type: string
                              enum:
                                - created
                                - credited
                                - voided
                                - confirmed
                              description: Current status of the deposit
                              example: credited
                            coordinates:
                              type: object
                              properties:
                                source-tax-id:
                                  type: string
                                  description: Tax ID of the sender (CPF/CNPJ)
                                  example: '12345678900'
                                source-bank-code:
                                  type: string
                                  description: Bank code of the sender
                                  example: '341'
                                source-type:
                                  type: string
                                  enum:
                                    - ted
                                    - pix
                                  description: Type of BRL transfer
                                  example: pix
                                source-account-number:
                                  type: string
                                  description: Account number of the sender
                                  example: 12345-6
                                source-branch-code:
                                  type: string
                                  description: Branch code of the sender
                                  example: '0001'
                                target:
                                  oneOf:
                                    - type: string
                                    - type: 'null'
                              additionalProperties: false
                              required:
                                - source-tax-id
                                - source-bank-code
                                - source-type
                                - source-account-number
                                - source-branch-code
                              description: Source banking information for the BRL deposit
                            created-at:
                              type: string
                              example: '2024-01-15T10:30:00Z'
                              format: date-time
                              description: ISO 8601 timestamp when the deposit was created
                            processed-at:
                              type: string
                              example: '2024-01-15T10:30:00Z'
                              format: date-time
                              description: >-
                                ISO 8601 timestamp when the deposit was
                                processed
                          additionalProperties: false
                          required:
                            - id
                            - type
                            - amount
                            - status
                            - coordinates
                            - created-at
                            - processed-at
                          description: List of BRL deposits
                    additionalProperties: false
                    required:
                      - deposits
                    title: BRL Deposits
                  - type: object
                    properties:
                      deposits:
                        type: array
                        items:
                          type: object
                          properties:
                            amount:
                              type: string
                              format: decimal
                              description: Amount of the deposit
                              example: '100.500000000000000000'
                            coordinates:
                              type: object
                              properties:
                                source-chain:
                                  type: string
                                  description: Source blockchain network
                                  example: eth-base
                                source-address:
                                  type: string
                                  description: Source wallet address
                                  example: '0x742d35Cc6635C0532925a3b8D295FD6C6e7e2c2c'
                                target-address:
                                  type: string
                                  description: Target wallet address
                                  example: '0xdDa4775Ed1d0c831B006FD4061Edb1b30693a44c'
                              additionalProperties: false
                              required:
                                - source-chain
                                - source-address
                                - target-address
                              description: >-
                                Source and target wallet addresses for the token
                                deposit
                            tx-hash:
                              type: string
                              description: Transaction hash for the token deposit
                              example: '0x1234567890abcdef1234567890abcdef12345678'
                            type:
                              type: string
                              enum:
                                - token
                                - pix
                                - manual-fx
                              description: Type of deposit
                              example: token
                            processed-at:
                              type: string
                              example: '2024-01-15T10:30:00Z'
                              format: date-time
                              description: >-
                                ISO 8601 timestamp when the deposit was
                                processed
                            status:
                              type: string
                              enum:
                                - created
                                - credited
                                - voided
                                - confirmed
                              description: Current status of the deposit
                              example: confirmed
                            id:
                              type: string
                              format: uuid
                              description: Unique identifier for the token deposit
                              example: 660e8400-e29b-41d4-a716-446655440001
                            created-at:
                              type: string
                              example: '2024-01-15T10:30:00Z'
                              format: date-time
                              description: ISO 8601 timestamp when the deposit was created
                            asset:
                              type: string
                              enum:
                                - eth-base/usdt
                                - eth-mainnet/usdt
                                - eth-mainnet/usdc
                                - eth-base/usdc
                              description: The token asset of the deposit
                              example: eth-base/usdc
                          additionalProperties: false
                          required:
                            - amount
                            - coordinates
                            - tx-hash
                            - type
                            - processed-at
                            - status
                            - id
                            - created-at
                            - asset
                          description: List of token deposits (USDC/USDT)
                    additionalProperties: false
                    required:
                      - deposits
                    title: Token Deposits
                  - type: object
                    properties:
                      deposits:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Unique identifier for the USD deposit
                              example: 660e8400-e29b-41d4-a716-446655440001
                            type:
                              type: string
                              enum:
                                - token
                                - pix
                                - manual-fx
                              description: Type of deposit
                              example: manual-fx
                            amount:
                              type: string
                              format: decimal
                              description: Amount of the deposit in USD
                              example: '100.50'
                            status:
                              type: string
                              enum:
                                - created
                                - credited
                                - voided
                                - confirmed
                              description: Current status of the deposit
                              example: confirmed
                            coordinates:
                              type: object
                              properties:
                                source:
                                  oneOf:
                                    - type: string
                                    - type: 'null'
                                target:
                                  oneOf:
                                    - type: string
                                    - type: 'null'
                              additionalProperties: false
                              description: Source and target information for the deposit
                            created-at:
                              type: string
                              example: '2024-01-15T10:30:00Z'
                              format: date-time
                              description: ISO 8601 timestamp when the deposit was created
                            processed-at:
                              oneOf:
                                - type: string
                                  example: '2024-01-15T10:30:00Z'
                                  format: date-time
                                  description: >-
                                    ISO 8601 timestamp when the deposit was
                                    processed
                                - type: 'null'
                          additionalProperties: false
                          required:
                            - id
                            - type
                            - amount
                            - status
                            - coordinates
                            - created-at
                          description: List of USD deposits
                    additionalProperties: false
                    required:
                      - deposits
                    title: USD Deposits
        '400':
          description: Bad request - Invalid input parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Bad request error details
                additionalProperties: false
                required:
                  - error
        '403':
          description: Forbidden - Access denied
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Forbidden access error details
                additionalProperties: false
                required:
                  - error
        '404':
          description: Not found - Resource does not exist
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Resource not found error details
                additionalProperties: false
                required:
                  - error
        '422':
          description: Unprocessable entity - Validation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
                      code:
                        type: string
                    additionalProperties: false
                    required:
                      - type
                      - message
                      - code
                    description: Validation error details
                additionalProperties: false
                required:
                  - error

````