# Convert amount (/en/docs/cartao/endpoints/currencies/get_currency_convert)

## GET /currencies/{code}/convert

`GET https://api.payzu.io/v1/currencies/{code}/convert`

Converts an amount given in BRL cents to the target currency, using the bid or ask rate.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `code` | string | yes | ISO 4217 currency code. BRL is not accepted. |

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `amount` | integer | yes | Amount in BRL cents. Minimum 100 (R$1.00). — minimum: 100 |
| `type` | string | yes | Which side of the rate to use. — `bid`, `ask` |

### Responses

**200** Converted amount.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `amount` | number | yes | Converted amount in the target currency, rounded to 2 decimals. |
| `currency` | object | yes |  |
| `currency.code` | string | no |  |
| `currency.rate` | object | no |  |
| `currency.rate.bid` | number | no |  |
| `currency.rate.ask` | number | no |  |