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

# Confirm Deposit Sender

> Registers the quarantined deposit's source address as a trusted sender for the account, subject to compliance screening. Confirmation is per sender, not per deposit: when approved immediately, every quarantined deposit from that sender is released and credited (result 'released') and future deposits from it are auto-confirmed; when manual review is required, the request stays pending (result 'pending-approval') and deposits remain quarantined until review completes. Retrying a confirmation for the same sender is idempotent. If the sender was rejected by a previous review, re-confirmation returns a business error and reconsideration is handled by Crown operations. Applies to token deposits only ('usdc' or 'usdt').



## OpenAPI

````yaml POST /api/v1/accounts/{account-id}/assets/{asset}/deposits/{id}/confirm-sender
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/v1/accounts/{account-id}/assets/{asset}/deposits/{id}/confirm-sender:
    post:
      summary: Confirm the sender of a quarantined deposit
      description: >-
        Registers the quarantined deposit's source address as a trusted sender
        for the account, subject to compliance screening. Confirmation is per
        sender, not per deposit: when approved immediately, every quarantined
        deposit from that sender is released and credited (result 'released')
        and future deposits from it are auto-confirmed; when manual review is
        required, the request stays pending (result 'pending-approval') and
        deposits remain quarantined until review completes. Retrying a
        confirmation for the same sender is idempotent. If the sender was
        rejected by a previous review, re-confirmation returns a business error
        and reconsideration is handled by Crown operations. Applies to token
        deposits only ('usdc' or 'usdt').
      parameters:
        - in: path
          name: account-id
          required: true
          schema:
            type: string
            format: uuid
        - in: path
          name: asset
          required: true
          schema:
            type: string
            enum:
              - usdc
              - usdt
          description: Sender confirmation applies to token deposits only
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: ID of the quarantined deposit
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              title: Confirm Sender Request
              properties:
                custody:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - self
                        - exchange
                      description: Custody arrangement of the sender address
                      example: self
                    custodian-name:
                      type:
                        - string
                        - 'null'
                      description: Custodian name, required when custody type is 'exchange'
                      example: Binance
                    country:
                      type: string
                      description: ISO alpha-3 country of custody
                      example: BRA
                  additionalProperties: false
                  required:
                    - type
                    - country
                  description: Custody details of the sender address
                owner:
                  type: object
                  properties:
                    type:
                      type: string
                      enum:
                        - account-holder
                        - third-party
                      description: Who owns the sender address
                      example: third-party
                    name:
                      type:
                        - string
                        - 'null'
                      description: Owner name, required when owner type is 'third-party'
                      example: Acme Trading LLC
                  additionalProperties: false
                  required:
                    - type
                  description: Ownership details of the sender address
                label:
                  type:
                    - string
                    - 'null'
                  description: Optional label for the confirmed sender wallet
                  example: Main exchange wallet
              additionalProperties: false
              required:
                - custody
                - owner
      responses:
        '200':
          description: Sender confirmation processed
          content:
            application/json:
              schema:
                type: object
                title: Confirm Sender Response
                properties:
                  result:
                    type: string
                    enum:
                      - released
                      - pending-approval
                    description: >-
                      Immediate outcome: 'released' when the quarantined
                      deposits from this sender were confirmed and credited;
                      'pending-approval' when the confirmation awaits review
                    example: released
                  deposit:
                    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
                          - brlv
                        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
                          - quarantined
                          - rejected
                        description: >-
                          Current status of the deposit. 'quarantined' means the
                          deposit came from a sender the account has not
                          confirmed and is held until the sender is confirmed;
                          'rejected' means the sender was reviewed and denied,
                          and the funds are not credited
                        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
                    title: Token Deposit
                additionalProperties: false
                required:
                  - result
                  - deposit
        '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

````