For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /api/withdrawal-orders/create.md.
  • English

    • Create Withdrawal Order

    Generated from the Finity OpenAPI specification.

    Base URLhttps://api2.finity.com.co

    Withdrawal Orders

    POST/v0/withdrawal-orders

    Create Withdrawal Order

    Create a new withdrawal order to transfer funds to an external account.

    Bearer token required

    Request

    This endpoint does not require parameters.

    JSON body *

    amount *: number
currency *: string
destination_id *: string

    Responses

    201Withdrawal order successfully created
    id: string
destination_id: string
destination: object
  id: string
  type: string
  bank_name: string
  account_number: string
  account_holder_fullname: string
  account_holder_id_type: string
  account_holder_id_number: string
amount: number
currency: string
state: string
costs: object
  commission *: number
  iva *: number
  total *: number
created_at: string (date-time)
updated_at: string (date-time)
    400Bad request – validation failed or malformed data
    401Unauthorized – missing or invalid authentication token
    404External account not found

    Try it live

    Live request

    Try this endpoint

    Configure the request and send it directly to the Finity API.

    POST
    Code language

    Authentication

    Use a Bearer token to authorize this request.

    Optional

    Request body

    Send a JSON payload with this request.

    JSON
    Request URLProduction
    POSThttps://api2.finity.com.co/v0/withdrawal-orders
    Generated Shell requestReady to copy
    curl -X POST \
  'https://api2.finity.com.co/v0/withdrawal-orders' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'