# Convert balances

Converts balance from one currency to another. In the API you can either send target_amount or source_amount and the API will calculate the other amount for you.

Endpoint: POST /balance_conversions
Version: 1.0.0
Security: JWT

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier for the balance balance.
    Example: "conv_6776d57dnbTWj"

  - `from` (object)
    the amount and currency of the balance used for conversion

  - `from.amount` (number)
    A positive integer representing the smallest currency unit.  For example, if the amount is $299.00, then pass 29900 in this field.  In the case of three decimal currencies, such as KWD, BHD and OMR, to represent an amount of 295.991, pass the value as 295990.  And in the case of zero decimal currencies such as JPY, for amount ￥295, pass the value as 295.
    Example: 1000

  - `from.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: "USD"

  - `to` (object)
    the amount and currency of the balance after conversion

  - `fees` (object)
    Total fees for the conversion

  - `mid_market_rate` (object)
    The mid-market rate at the time of conversion

  - `mid_market_rate.rate` (number)
    The the conversion rate used for the currency(ies) for a given transaction.
    Example: 1.4

  - `status` (string)
    The status of the balance conversion.
    Enum: "success", "failed", "pending"

  - `created_at` (string)
    The date and time the balance conversion was created.
    Example: "2021-01-01T00:00:00Z"

## Response 400 fields (application/json):

  - `error` (string)
    Enum: "Bad Request"

  - `message` (string)
    Error message.
    Example: "You can only send source_amount or target_amount, not both."