---
title: "Get currency"
method: GET
path: "/api-regulated/v1/currencies/{code}"
tags: ["Currency"]
---

# Get currency

`GET /api-regulated/v1/currencies/{code}`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/currencies/{code}`
- Auth: HTTP bearer

Fetches detailed information for a specific currency identified by its ISO code.

## Path parameters

- `code` string, required

## Response `200`

Currency retrieved

- CurrencyDTO: Schema for representing a Currency
  - `code` string: ISO 4217 currency code
  - `description` string: Description of the currency
  - `precision` integer: Precision of the currency (number of decimal places)
  - `calendarCode` string: Industry standard calendar codes
  - `isActive` boolean: Whether this currency is active. Tombstone flag: false = soft-deleted.
  - `rateRoute` 'DIRECT' | 'FX_IMPLIED': How this currency's discount factors are obtained: DIRECT from a bought curve, or FX_IMPLIED from the USD curve and forward points.
  - `eventSequence` integer: Event sequence number for event sourcing - globally monotonic across all entities
  - `versionNumber` integer: Strictly monotonically increasing version number for this record
  - `updatedBy` string: Username of the person or entity that updated this record
  - `updatedAt` string: Timestamp of the last update in UTC
  - `createdAt` string: Timestamp of creation in UTC

## Other responses

- `400`: Invalid code — [`http/malformed-request`](/problems/http/malformed-request/)
- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: Currency not found — [`http/resource-not-found`](/problems/http/resource-not-found/)
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)