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

# Create Withdrawal

> Creates a withdrawal for fiat (PIX/TED) or tokens. For fiat BRL, use asset 'fiat/brl' with method 'pix' or 'ted'. For tokens, use asset like 'eth-base/usdc' with method 'token'.



## OpenAPI

````yaml POST /api/v0/withdrawals
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/withdrawals:
    post:
      summary: Create a withdrawal
      description: >-
        Creates a withdrawal for fiat (PIX/TED) or tokens. For fiat BRL, use
        asset 'fiat/brl' with method 'pix' or 'ted'. For tokens, use asset like
        'eth-base/usdc' with method 'token'.
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
                - type: object
                  properties:
                    asset:
                      enum:
                        - fiat/brl
                      example: fiat/brl
                    method:
                      enum:
                        - pix
                      example: pix
                    amount:
                      oneOf:
                        - type: string
                        - type: number
                          format: double
                    pix-key:
                      type: string
                      description: PIX key
                      example: user@example.com
                  additionalProperties: false
                  required:
                    - asset
                    - method
                    - amount
                    - pix-key
                  description: BRL PIX withdrawal
                  title: PIX Withdrawal
                - type: object
                  properties:
                    asset:
                      enum:
                        - fiat/brl
                      example: fiat/brl
                    method:
                      enum:
                        - ted
                      example: ted
                    amount:
                      oneOf:
                        - type: string
                        - type: number
                          format: double
                    bank-code:
                      type: string
                    branch-number:
                      type: string
                    account-number:
                      type: string
                    account-holder-name:
                      type: string
                    account-holder-tax-id:
                      oneOf:
                        - type: string
                        - type: string
                  additionalProperties: false
                  required:
                    - asset
                    - method
                    - amount
                    - bank-code
                    - branch-number
                    - account-number
                    - account-holder-name
                    - account-holder-tax-id
                  description: BRL TED withdrawal
                  title: TED Withdrawal
                - type: object
                  properties:
                    asset:
                      type: string
                      enum:
                        - eth-mainnet/usdc
                        - eth-base/usdc
                      description: Stablecoin asset
                      example: eth-base/usdc
                    amount:
                      oneOf:
                        - type: string
                        - type: number
                          format: double
                    destination-wallet-address:
                      type: string
                      description: External wallet address
                      example: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
                  additionalProperties: false
                  required:
                    - asset
                    - amount
                    - destination-wallet-address
                  description: Crypto stablecoin withdrawal
                  title: Stablecoin Withdrawal
      responses:
        '200':
          description: Withdrawal created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  withdrawal:
                    oneOf:
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                            example: 660e8400-e29b-41d4-a716-446655440001
                          asset:
                            enum:
                              - fiat/brl
                            example: fiat/brl
                          amount:
                            type: string
                            format: decimal
                            example: '100.50'
                          method:
                            enum:
                              - pix
                            example: pix
                          state:
                            type: string
                            enum:
                              - created
                              - rolled-back
                              - completed
                              - processing
                            example: created
                          created-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                          state-updated-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                        additionalProperties: false
                        required:
                          - id
                          - asset
                          - amount
                          - method
                          - state
                          - created-at
                          - state-updated-at
                        description: BRL PIX withdrawal
                        title: PIX Withdrawal
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                            example: 660e8400-e29b-41d4-a716-446655440002
                          asset:
                            enum:
                              - fiat/brl
                            example: fiat/brl
                          amount:
                            type: string
                            format: decimal
                            example: '1500.00'
                          method:
                            enum:
                              - ted
                            example: ted
                          state:
                            type: string
                            enum:
                              - created
                              - rolled-back
                              - completed
                              - processing
                            example: created
                          created-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                          state-updated-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                        additionalProperties: false
                        required:
                          - id
                          - asset
                          - amount
                          - method
                          - state
                          - created-at
                          - state-updated-at
                        description: BRL TED withdrawal
                        title: TED Withdrawal
                      - type: object
                        properties:
                          id:
                            type: string
                            format: uuid
                            example: 660e8400-e29b-41d4-a716-446655440003
                          asset:
                            type: string
                            enum:
                              - eth-mainnet/usdc
                              - eth-base/usdc
                            description: Stablecoin asset
                            example: eth-base/usdc
                          amount:
                            type: string
                            format: decimal
                            example: '100.500000000000000000'
                          state:
                            type: string
                            enum:
                              - created
                              - rolled-back
                              - completed
                              - processing
                            example: created
                          created-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                          state-updated-at:
                            type: string
                            example: '2025-03-06T10:30:00Z'
                            format: date-time
                          destination-wallet-address:
                            type: string
                            description: Destination wallet address
                            example: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
                          tx-hash:
                            type: string
                            description: Transaction hash for completed withdrawal
                            example: 0x1234567890abcdef...
                        additionalProperties: false
                        required:
                          - id
                          - asset
                          - amount
                          - state
                          - created-at
                          - state-updated-at
                        description: Crypto stablecoin withdrawal
                        title: Stablecoin Withdrawal
                additionalProperties: false
                required:
                  - withdrawal
                title: Create Withdrawal Response
        '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

````