# Currencies

`GET` _(Table: Currency)_

```
eOne/core/v1.0/currencies
```

"Read-only currency master. Every amount this API publishes is in its own record's transaction currency, and a blank `currencyCode` means the company local currency, so a store that reports across more than one currency needs this list and the rates beside it."

## What it is for

SmartConnect maps land `currencyCode` on customers, vendors, documents, ledger entries and journal lines. That code is a key, not a description: it tells you nothing about how many decimals the currency uses, what its ISO code is, or which accounts its exchange gains post to.

This endpoint answers that, and it is small enough to refresh on every run.

## Pair it with rates

A currency on its own does not convert anything. [`currencyExchangeRates`](https://eonesolutions.github.io/eone-bc-integration/core-currencyExchangeRates.md) carries the rate history, and the two together are what let a report state one consolidated total.

## Blank is a real value

A blank `currencyCode` anywhere in this API means the transaction was in the company local currency. There is no row here for it, because Business Central does not store LCY as a currency. Read the company's own local currency from General Ledger Setup, not from this feed.

## Currencies fields

_API column → BC field._

**Legend**

- _(req)_ required on create
- _(res)_ resolver
- _(cur)_ currency-translated
- _(ro)_ read-only
- _(ext)_ added to this endpoint by another extension (BC field name shown; its API column name is not known here)

| API | BC field | Notes |
| --- | --- | --- |
| `id` | SystemId | The Business Central record id. Unique on its own, and the key this feed is written against. _(ro)_ |
| `bcCompanyId` | bcCompanyId | The company this row belongs to - the same GUID that appears in the request URL. Present on every endpoint so a store pooling several companies can keep them apart without relying on which URL it called. _(ro)_ |
| `bcCompanyName` | bcCompanyName | The name of the company this row belongs to. _(ro)_ |
| `code` | Code | The currency code, e.g. EUR. This is the natural key, and the value that appears in every currencyCode column elsewhere in this API. _(ro)_ |
| `displayName` | Description | The currency name. _(ro)_ |
| `symbol` | Symbol | The currency symbol, when one is configured. _(ro)_ |
| `isoCode` | ISO Code | The ISO 4217 three-letter code. _(ro)_ |
| `isoNumericCode` | ISO Numeric Code | The ISO 4217 numeric code. _(ro)_ |
| `amountRoundingPrecision` | Amount Rounding Precision | The precision amounts in this currency are rounded to. _(ro)_ |
| `amountDecimalPlaces` | Amount Decimal Places | How many decimal places amounts in this currency display. _(ro)_ |
| `unitAmountRoundingPrecision` | Unit-Amount Rounding Precision | The precision unit prices and unit costs in this currency are rounded to. _(ro)_ |
| `invoiceRoundingPrecision` | Invoice Rounding Precision | The precision invoice totals in this currency are rounded to. _(ro)_ |
| `realizedGainsAccount` | Realized Gains Acc. | The G/L account realized exchange gains post to. _(ro)_ |
| `realizedLossesAccount` | Realized Losses Acc. | The G/L account realized exchange losses post to. _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | The last date and time the record was modified. Use it as the watermark for an incremental pull. _(ro)_ |