# Converter valor (/docs/cartao/endpoints/currencies/get_currency_convert)

## GET /currencies/{code}/convert

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

Converte um valor informado em centavos de BRL para a moeda de destino, usando a cotação bid ou ask. A saída também é expressa em centavos da moeda de destino.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `code` | string | yes | Código de moeda ISO 4217. BRL não é aceito. |

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `amount` | integer | yes | Valor em centavos de BRL. Mínimo 100 (R$1,00). — minimum: 100 |
| `type` | string | yes | Qual lado da cotação usar. — `bid`, `ask` |

### Responses

**200** Valor convertido.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `amount` | number | yes | Valor convertido, em centavos da moeda de destino (`amount` dividido pela cotação), arredondado a 2 casas decimais. |
| `currency` | object | yes | Moeda de destino e a cotação usada na conversão. |
| `currency.code` | string | no |  |
| `currency.rate` | object | no |  |
| `currency.rate.bid` | number | no |  |
| `currency.rate.ask` | number | no |  |