European Central BankEuropean Central Bank Data Portal SDMX API
GET/data/{flowRef}/{key}
Get data by dataflow and Series key
Returns time series matching a Series key within a dataflow. The key follows DSD dimension order with dot separators; an empty segment is a wildcard and `+` is OR. Bound response size with date or observation-count parameters.
Query the European Central Bank's public SDMX 2.1 statistical data, structural metadata, and structure-specific XML schemas, including complete path variants, content negotiation, and 12 searchable schemas.
Request
- operationId
getDataBySeriesKey- Server
https://data-api.ecb.europa.eu/service- Authentication
- None
Request parameters
flowRef
pathstringrequired
Dataflow reference: a flow ID, or comma-separated agency ID, flow ID, and version.
EXR
key
pathstringrequired
Series key in DSD dimension order; dot-separated, with empty wildcard segments and `+` for OR.
M.USD.EUR.SP00.A
startPeriod
querystring
An ISO 8601 or SDMX reporting period: annual, semi-annual, quarterly, monthly, weekly, or daily.
2024-01
endPeriod
querystring
An ISO 8601 or SDMX reporting period: annual, semi-annual, quarterly, monthly, weekly, or daily.
2024-01
updatedAfter
querystringdate-time
Return the latest values added, revised, or deleted after this ISO 8601 timestamp.
2024-01-01T00:00:00Z
firstNObservations
queryinteger
Maximum observations returned per matching time series, starting at the first observation.
1
lastNObservations
queryinteger
Maximum observations returned per matching time series, counting backward from the latest observation.
1
detail
querystring
Amount of data detail returned.
full
includeHistory
queryboolean
Whether to include historical versions of matching data.
false
format
querystring
Response format; it can also be selected through the Accept header.
jsondata
If-Modified-Since
headerstringhttp-date
HTTP conditional-request timestamp. The service returns 304 when data has not changed.
Mon, 01 Jan 2024 00:00:00 GMT
Accept
headerstring
Selects the response representation. The ECB recommends versioned, specific media types.
application/vnd.sdmx.data+json;version=1.0.0-wd
Accept-Encoding
headerstring
Requests a compressed response, for example gzip.
gzip
Responses
200
SdmxDataMessageapplication/vnd.sdmx.data+json;version=1.0.0-wdapplication/jsontext/csvapplication/vnd.ecb.data+csv;version=1.0.0application/vnd.sdmx.genericdata+xml;version=2.1application/vnd.sdmx.structurespecificdata+xml;version=2.1application/xml
Successful request; the representation is selected by the format query parameter or Accept header.
Properties: headerdataSetsstructure
304
unknown
No change since the If-Modified-Since value; the response has no body.
400
ErrorBodytext/plainapplication/xmlapplication/json
The query parameters contain a syntax or semantic error.
404
ErrorBodytext/plainapplication/xmlapplication/json
No result matched the query.
406
ErrorBodytext/plainapplication/xmlapplication/json
The requested representation is not supported.
500
ErrorBodytext/plainapplication/xmlapplication/json
An internal ECB service error occurred.
501
ErrorBodytext/plainapplication/xmlapplication/json
The request uses SDMX REST functionality not implemented by the ECB service.
503
ErrorBodytext/plainapplication/xmlapplication/json
The ECB service is temporarily unavailable.
{
"header": {
"id": "b8cdb8e9-3de8-41f7-a83e-c6e475a6e7ab",
"test": false,
"prepared": "2026-08-14T16:23:35.250+02:00",
"sender": {
"id": "ECB"
}
},
"dataSets": [
{
"action": "Replace",
"validFrom": "2026-08-14T16:23:35.250+02:00",
"series": {}
}
],
"structure": {
"links": [
{
"title": "Exchange Rates",
"rel": "dataflow",
"href": "https://data-api.ecb.europa.eu/service/dataflow/ECB/EXR/1.0"
}
],
"name": "Exchange Rates",
"dimensions": {
"series": [
{
"id": "FREQ",
"name": "Frequency",
"role": "time",
"values": [
{
"id": "M",
"name": "Monthly",
"start": "2024-01-01T00:00:00.000+01:00",
"end": "2024-01-31T23:59:59.999+01:00"
}
]
}
],
"observation": [
{
"id": "FREQ",
"name": "Frequency",
"role": "time",
"values": [
{
"id": "M",
"name": "Monthly",
"start": "2024-01-01T00:00:00.000+01:00",
"end": "2024-01-31T23:59:59.999+01:00"
}
]
}
]
},
"attributes": {
"series": [
{
"id": "FREQ",
"name": "Frequency",
"role": "time",
"values": [
{
"id": "M",
"name": "Monthly",
"start": "2024-01-01T00:00:00.000+01:00",
"end": "2024-01-31T23:59:59.999+01:00"
}
]
}
],
"observation": [
{
"id": "FREQ",
"name": "Frequency",
"role": "time",
"values": [
{
"id": "M",
"name": "Monthly",
"start": "2024-01-01T00:00:00.000+01:00",
"end": "2024-01-31T23:59:59.999+01:00"
}
]
}
]
}
}
}