---
title: "Query currencies"
method: GET
path: "/currencies"
tags: ["Currency"]
---

# Query currencies

`GET /currencies`

## Request

- Base URL: `https://r38.coupadev.com/api`
- URL: `https://r38.coupadev.com/api/currencies`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://r38.coupadev.com/oauth2/authorizations/new`
    - Token URL: `https://r38.coupadev.com/oauth2/token`
  - OAuth 2
    - Client credentials
    - Token URL: `https://r38.coupadev.com/oauth2/access_tokens`
- TypeScript: <https://skmtc.dev/coupa/apis/coupa-api-4/docs/currencies/get.ts> (a function with typed inputs; its response is checked against the schema)

Query currencies

## Query parameters

- `limit` integer
- `offset` integer
- `order_by` string
- `dir` 'asc' | 'desc'
- `return_object` 'limited' | 'shallow' | 'none'
- `filter` string

## Response `200`

Currency objects

- Currency[]
  - `code` string, string(6), required: code
  - `decimals` integer: Decimal precision
  - `enabled` boolean: Enabled
  - `id` integer: Coupa unique identifier
  - `name` string, string(100), required: name
  - `symbol` string, string(10): symbol

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/coupa/apis/coupa-api-4.md) - [All operations](https://skmtc.dev/coupa/apis/coupa-api-4/llms.txt) - [OpenAPI document](https://skmtc.dev/coupa/apis/coupa-api-4/revisions/adc09cabd758?raw)