---
title: "Retrieve a currency"
method: GET
path: "/quickbooks-desktop/currencies/{id}"
---

# Retrieve a currency

`GET /quickbooks-desktop/currencies/{id}`

Retrieves a currency by ID.

**IMPORTANT:** If you need to fetch multiple specific currencies by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.

## Path parameters

- `id` string, required — The QuickBooks-assigned unique identifier of the currency to retrieve.

## Headers

- `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request.

## Response `200`

Returns the specified currency.

- QbdCurrency
  - `id` string, required — The unique identifier assigned by QuickBooks to this currency. This ID is unique across all currencies but not across different QuickBooks object types.
  - `objectType` 'qbd_currency', required — The type of object. This value is always `"qbd_currency"`.
  - `createdAt` string, required — The date and time when this currency was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
  - `updatedAt` string, required — The date and time when this currency was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
  - `revisionNumber` string, required — The current QuickBooks-assigned revision number of this currency object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you're working with the latest data; otherwise, the update will return an error.
  - `name` string, required — The case-insensitive unique name of this currency, unique across all currencies. For built-in currencies, the name is the internationally accepted currency name and is not editable. **NOTE**: Currencies do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.
  - `isActive` boolean, required — Indicates whether this currency is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.
  - `currencyCode` string, required — The internationally accepted currency code used by this currency, typically based on the ISO 4217 standard (for example, USD for US Dollars). Built-in QuickBooks currencies follow ISO 4217. For user-defined currencies, following ISO 4217 is recommended but not required. In many cases, the three-letter code is formed from the country's two-letter internet code plus a currency letter (e.g., BZ + D → BZD for Belize Dollar).
  - `currencyFormat` QbdCurrencyFormat, required
    - `thousandSeparator` 'apostrophe' | 'comma' | 'period' | 'space', nullable, required — Controls the thousands separator when displaying currency values (for example, "1,000,000"). Defaults to comma.
    - `thousandSeparatorGrouping` 'x_xx_xx_xxx' | 'xx_xxx_xxx', nullable, required — Controls how digits are grouped for thousands when displaying currency values (for example, "10,000,000").
    - `decimalPlaces` '0' | '2', nullable, required — Controls the number of decimal places displayed for currency values. Use `0` to hide decimals or `2` to display cents.
    - `decimalSeparator` 'comma' | 'period', nullable, required — Controls the decimal separator when displaying currency values (for example, "1.00" vs "1,00"). Defaults to period.
  - `isUserDefinedCurrency` boolean, nullable, required — Indicates whether this currency was created by a QuickBooks user (`true`) or is a built-in currency (`false`).
  - `exchangeRate` number, nullable, required — The market exchange rate between this currency's currency and the home currency in QuickBooks at the time of this transaction. Represented as a decimal value (e.g., 1.2345 for 1 EUR = 1.2345 USD if USD is the home currency).
  - `asOfDate` string, date, nullable, required — The date when the exchange rate for this currency was last updated, in ISO 8601 format (YYYY-MM-DD).

---

[API](https://skmtc.net/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.net/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/revisions/0b07b3ebe160/schema)