# List currencies

`GET /client_api/v2/currencies`

The currencies we price in. Needs no token.

Needs no token.

## Parameters

- `show_all` (boolean): Send `true` to get every currency on one page.

## Returns

Returns a list of currencies.

- `currencies` (array of objects, required): The currencies on this page, by code.
  - `id` (string, required): The currency's three-letter code, the same as `code`.
  - `code` (string, required): The currency's three-letter ISO code, such as `ZAR`.
  - `name` (string, required): The currency's name.
- `meta` (object, required): How many pages and records the list has.
  - `page_count` (integer, required): How many pages the list has. Ask for another with `?page=`.
  - `record_count` (integer, required): How many records the list has across all pages.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/currencies?show_all=true"
```

## Example response (200)

```json
{
  "currencies": [
    {
      "id": "CAD",
      "code": "CAD",
      "name": "Canadian Dollar"
    },
    {
      "id": "EUR",
      "code": "EUR",
      "name": "Euro"
    },
    {
      "id": "GBP",
      "code": "GBP",
      "name": "Pound"
    },
    {
      "id": "USD",
      "code": "USD",
      "name": "Dollar"
    },
    {
      "id": "ZAR",
      "code": "ZAR",
      "name": "Rand"
    }
  ],
  "meta": {
    "page_count": 1,
    "record_count": 5
  }
}
```