Making an API Request Using cURL

This article is ideal if you're looking to test the API quickly.

curl is a command-line tool used to transfer data to or from a server, often used for testing APIs. It supports various protocols, including HTTP and HTTPS.

POST Request - Retrieve token

Run the following command in the terminal to retrieve a token for the FMS production environment. Please make sure to replace the YOUR_REGISTERED_EMAIL_ADDRESS and YOUR_TP_PASSWORD with your own credentials.

curl --location 'https://keycloak.tp.entsoe.eu/realms/tp/protocol/openid-connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=tp-fms-public' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'username=YOUR_TP_EMAIL_ADDRESS' \
--data-urlencode 'password=YOUR_TP_PASSWORD'

Response:

{
    "access_token": "YOUR_TOKEN",
    "expires_in": 900,
    "refresh_expires_in": 1800,
    "refresh_token": "eyJhbGciOiJIUzUxMiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJhNTgzNGNhYi1hMjYxLTQ3YTMtODZlZi1mNWJhNDg5ZjZkMDUifQ.eyJleHAiOjE3NTAyMzUzMTIsImlhdCI6MTc1MDIzMzUxMiwianRpIjoiNDkzMmYyYWMtMmY5Zi00OTQ5LTlmNTQtMGM4MDczZDQxYWZlIiwiaXNzIjoiaHR0cHM6Ly9rZXljbG9hay50cC5lbnRzb2UuZXUvcmVhbG1zL3RwIiwiYXVkIjoiaHR0cHM6Ly9rZXljbG9hay50cC5lbnRzb2UuZXUvcmVhbG1zL3RwIiwic3ViIjoiMzhlZDZlYWItM2M1Zi00OTk2LTg5NWItNTE5MmRmNzAxYzIwIiwidHlwIjoiUmVmcmVzaCIsImF6cCI6InRwLWZtcy1wdWJsaWMiLCJzaWQiOiJhMmQ3MWNhYi0zZDU3LTRhNjItODY4Zi04YWZkNzRmYjU5ZjAiLCJzY29wZSI6ImFjciByb2xlcyB1c3ktdHAtdXNlcmcwMSBiYXNpYyBwcm9maWxlIHdlYi1vcmlnaW5zIHVzeS10cC1hcmNoaXZpbmdnMDEgZW1haWwifQ.525vkTwi1_d15i60Ie0h17P_19rLo2mWBGT-JwUqZDDIS1-wyc2HiWZGgtWEuoLuQXM0fIjzuQaPdLL0QpHGmw",
    "token_type": "Bearer",
    "not-before-policy": 1741117187,
    "session_state": "a2d71cab-3d57-4a62-868f-8afd74fb59f0",
    "scope": "usy-tp-userg01 profile usy-tp-archivingg01 email"
}

POST Request - List File Metadata

Run the following command in the terminal to list file metadata.

curl --location 'https://fms.tp.entsoe.eu/listFileMetadata' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "topLevelFolder": "TP_export",
    "typeSpecificAttributeMap": { 
                                    "path": "/TP_export/AcceptedAggregatedOffers_17.1.D/"
                                },
    "sorterList": [
        {
            "key": "lastUpdatedTimestamp",
            "ascending": false 
        }
    ],
    "pageInfo": { 
        "pageIndex": 0,
        "pageSize": 5000
    }
}'

Response:

{
    "uuAppErrorMap": {},
    "itemList": [
        {
            "fileId": "960d2fb0-94de-4d9d-a3cb-ba22a882f36f",
            "version": 14,
            "isLatestVersion": true,
            "topLevelFolder": "TP_export",
            "source": "entsoe-reporting",
            "createdTimestamp": "2025-06-05T14:59:35.018Z",
            "lastUpdatedTimestamp": "2025-06-18T08:03:42.715Z",
            "periodCovered": {
                "from": "2025-06-01T00:00:00Z",
                "to": "2025-07-01T00:00:00Z"
            },
            "typeSpecificAttributeMap": {
                "path": "/TP_export/AcceptedAggregatedOffers_17.1.D/"
            },
            "contentMetadata": null,
            "content": {
                "contentId": "800741f9889b32f4c35359b9f9bccf7b0b4bc18ee91771290fb8e9fe740db181",
                "filename": "2025_06_AcceptedAggregatedOffers_17.1.D.csv",
                "transformation": "ZIP",
                "mediaType": "text/csv",
                "size": 253091,
                "originalSize": 5265622
            },
            "deleted": false
        },
        {
            "fileId": "8f1a54f7-316d-49b5-9315-157666d5410f",
            "version": 2,
            "isLatestVersion": true,
            "topLevelFolder": "TP_export",
            "source": "entsoe-reporting",
            "createdTimestamp": "2025-06-05T14:59:34.656Z",
            "lastUpdatedTimestamp": "2025-06-16T09:51:32.688Z",
            "periodCovered": {
                "from": "2025-05-01T00:00:00Z",
                "to": "2025-06-01T00:00:00Z"
            },
            "typeSpecificAttributeMap": {
                "path": "/TP_export/AcceptedAggregatedOffers_17.1.D/"
            },
            "contentMetadata": null,
            "content": {
                "contentId": "c1231b7ecffb3d648c4883b339898b62dbe1fe774e74cd8ed90af12d128520c0",
                "filename": "2025_05_AcceptedAggregatedOffers_17.1.D.csv",
                "transformation": "ZIP",
                "mediaType": "text/csv",
                "size": 434352,
                "originalSize": 8898292
            },
            "deleted": false
        },
        {
            "fileId": "f6098756-1e45-489a-96c4-d99c9b480689",
            "version": 2,
            "isLatestVersion": true,
            "topLevelFolder": "TP_export",
            ...