Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Embat ForeignExchangeRates API

`ForeignExchangeRate` records the daily exchange rates Embat uses to convert amounts between currencies for accounting purposes. Each record captures the rates observed on a given `date` for a set of currencies against a `baseCurrency` (EUR as stored).These are the same rates Embat applies internally when it computes exchange rates and accounting amounts on entities such as `Payment`, `Balance` and `Transaction`. Foreign exchange rates are read-only reference data: this API does not support creating, updating or deleting them.**Typical flow:** look up the rate for a given day to reproduce or audit a currency conversion made elsewhere in Embat.1. List the rates for a date range, optionally expressed against a currency other than EUR:```GET /foreignexchangerates?baseCurrency=USD&startDate=2024-01-01&endDate=2024-01-31```2. Or retrieve a single record you already know the `id` of, always expressed against EUR:```GET /foreignexchangerates/{id}```

Embat ForeignExchangeRates API is one of 22 APIs that Embat publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include ForeignExchangeRates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 6 schemas. It is described by OpenAPI 3.1.0, at version 2.120.3.

Requests are made against the base URL https://api.embat.io.

2 operations 2 paths 6 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.120.3
Base URL
https://api.embat.io
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Embat ForeignExchangeRates API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

ForeignExchangeRates 2

ForeignExchangeRate records the daily exchange rates Embat uses to convert amounts between currencies for accounting purposes. Each record captures the rates observed on a given d…

GET
/foreignexchangerates
List foreign exchange rates
list_foreign_exchange_rates_foreignexchangerates_get 5 params → 200401404422
GET
/foreignexchangerates/{id}
Retrieve foreign exchange rate
retrieve_foreign_exchange_rate_foreignexchangerates__id__get 1 param → 200401404422

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are GetForeignExchangeRatesResponseSchema (6 properties), ValidationError (5 properties), ListForeignExchangeRatesResponseSchema (2 properties), HTTPValidationError (1 property). Each schema is shown below with its type and property counts.

ListForeignExchangeRatesResponseSchema
object
2 properties 1 required
ErrorResponse
object
Error payload returned by the API (FastAPI detail convention).
1 property 1 required
CurrencyEnum
string
HTTPValidationError
object
1 property
ValidationError
object
5 properties 3 required
GetForeignExchangeRatesResponseSchema
object
Foreign exchange rates response data schema
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

embat-foreignexchangerates-api-openapi.yml Raw ↑

Other APIs Embat publishes across the network.

Embat AccountingAccounts API
Embat AccountingEntries API
Embat Attributes API
Embat Authentication API
Embat Balances API
Embat Banks API
Embat Categories API
Embat Companies API
Embat Contacts API
Embat DebtScheduleConfigs API
Embat Files API
Embat Forecasts API