Convertesc API OpenAPI YAML Discovery Example Latest Example Historical Fallback Example

BNR Exchange Rates API (Latest & Historical)

API curs valutar BNR: integrare rapidă

Documentație tehnică pentru integrare API curs valutar BNR în aplicații PHP, JavaScript sau servicii backend. Include endpoint-uri latest și historical, comportamentul strict_date, fallback pentru zile fără publicare, paginare cu cursor și verificări de stare.

FAQ integrare API curs valutar

Resurse tehnice recomandate

Termeni căutați de programatori

api curs valutar, api curs valutar bnr, curs valutar istoric api, bnr rates api latest, ron fx rates json api, currency conversion api ron base.

API Reference

BNR Exchange Rates API (Convertesc) 1.0.0. Base URL: https://convertesc.ro.

Public read-only API curs valutar BNR with latest, historical, strict_date, cursor pagination and health endpoints.

GET /api/v1

API discovery

API discovery

Parameters

No parameters.

Responses

Status Description Schema
200 Discovery payload DiscoveryResponse
GET /api/v1/latest

Latest rates

Latest rates

Parameters

Name In Required Type Description
base query optional string Base currency code.
symbols query optional string Comma-separated currency codes.
include_multipliers query optional boolean Include BNR source quote multipliers as optional metadata. Rates remain normalized per one unit of base currency.

Responses

Status Description Schema
200 Latest rates RatesResponse
400 Invalid request ErrorResponse
404 Resource not found ErrorResponse
GET /api/v1/historical/{date}

Historical rates for a specific date

Historical rates for a specific date

Parameters

Name In Required Type Description
date path required string / date -
base query optional string Base currency code.
symbols query optional string Comma-separated currency codes.
include_multipliers query optional boolean Include BNR source quote multipliers as optional metadata. Rates remain normalized per one unit of base currency.
strict_date query optional boolean When true, require exact date match. When false (default), missing dates fall back to the previous available BNR date.

Responses

Status Description Schema
200 Historical rates RatesResponse
400 Invalid request ErrorResponse
404 Resource not found ErrorResponse
GET /api/v1/pairs/{from}/{to}/history

Historical pair rates for charting

Historical pair rates for charting

Parameters

Name In Required Type Description
from path required string -
to path required string -
range query optional 1m | 3m | 6m | 1y -
limit query optional integer -

Responses

Status Description Schema
200 Pair history rates PairHistoryResponse
400 Invalid request ErrorResponse
404 Resource not found ErrorResponse
GET /api/v1/currencies

Supported currencies

Supported currencies

Parameters

No parameters.

Responses

Status Description Schema
200 Currency list CurrenciesResponse
400 Invalid request ErrorResponse
GET /api/v1/dates

Available BNR dates

Available BNR dates

Parameters

Name In Required Type Description
limit query optional integer -
offset query optional integer Offset pagination. Cannot be combined with cursor.
cursor query optional string / date Cursor pagination based on the last received date (YYYY-MM-DD). Cannot be combined with offset.
q query optional string Optional date search text. Accepts ISO dates or Romanian-style date labels such as 24-04-2026.
exclude_latest query optional boolean Exclude the newest available BNR date from the list.

Responses

Status Description Schema
200 Available dates DatesResponse
400 Invalid request ErrorResponse
GET /api/v1/health

API health status

API health status

Parameters

No parameters.

Responses

Status Description Schema
200 Health payload HealthResponse

Response Schemas

RatesResponse

Property Type Required Description
success boolean required -
date string / date required -
base string required -
rates object required Exchange rates normalized per one unit of the requested base currency.
multipliers object optional Present only when include_multipliers=1. BNR source quote multipliers for the base and returned symbols.
requested_date string / date optional Present on historical responses to show original requested date.
fallback_applied boolean optional Present on historical responses. True when date fallback was used.
meta Meta required -

CurrenciesResponse

Property Type Required Description
success boolean required -
currencies array<string> required -
meta Meta required -

DatesResponse

Property Type Required Description
success boolean required -
dates array<string / date> required -
meta object required -

PairHistoryResponse

Property Type Required Description
success boolean required -
pair object required -
points array<object> required -
meta object required -

HealthResponse

Property Type Required Description
success boolean required -
status string required -
latest_date string / date required -
import object optional -
meta Meta required -

DiscoveryResponse

Property Type Required Description
success boolean required -
name string required -
version string required -
base_url string required -
docs object required -
endpoints array<object> required -
examples array<string> required -
meta Meta required -

ErrorResponse

Property Type Required Description
success boolean required -
error object required -
meta Meta required -

Meta

Property Type Required Description
request_id string required -