# Currency rates · codes

`GET https://bemap.benomad.com/bgis/service/currency/1.0/codes`

Part of [Currency](https://benomad.com/dev/doc/bemap-api/more-services/currency.md).

> **List currencies.** The currency codes the conversion knows.

To get all currency rates.

Requires the Currency or EV smart routing option (Allow to get currency information); without it BeMap answers `400 Access Denied`.

## Response

`200`, schema `CurrencyCode[]`.

An array of `CurrencyCode`, each with:

- `code` (string): Currency ISO 4217 Code.
- `label` (string): Label / name of currency.
- `byDefault` (boolean): True if is the currency code of base.

## Errors

- `400`: Bad Request
- `302`: no credentials were sent. Do not follow the redirect.
- `401`: the account or the API key is wrong.

How to read each one: [Errors](https://benomad.com/dev/doc/bemap-api/getting-started/errors.md).

## Example

```bash
curl -X GET 'https://bemap.benomad.com/bgis/service/currency/1.0/codes' \
  -u 'YOUR_ACCOUNT:YOUR_API_KEY' \
  --fail-with-body
```

Response captured from production, long arrays and strings shortened:

```json
[
  {
    "code": "FJD",
    "label": "Fijian Dollar",
    "byDefault": false
  },
  {
    "code": "STD",
    "label": "São Tomé and Príncipe Dobra",
    "byDefault": false
  }
]
```

## Reference pages

- [Currency rates · codes](https://benomad.com/dev/doc/bemap-api/guides/services/currency-codes.md)