Securely Redirecting...

Connecting to Stripe

Back to API Index

Retail Sales (PLN)

Measures change in the total value of sales at the retail level.

Category: Economy

API Endpoint

/api/v1/announcements/pln/retail_sales

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Data Source

Primary Source

NBP/GUS

Official Series ID

GUS/P4023

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

%YoY

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

{
    "currency": "PLN",
    "indicator": "retail_sales",
    "has_official_forecast": false,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "data": [
        {
            "date": "2024-07-01",
            "val": 4.2,
            "announcement_datetime": 1722456000
        }
    ]
}

Request Parameters & Usage

Parameter Required Format Description
start_date NO YYYY-MM-DD Optional lower bound for the requested history.
end_date NO YYYY-MM-DD Optional upper bound. Defaults to the current date.
api_key CONDITIONAL string Required for non-USD and paid access. USD endpoints are available free without an API key.

Example Usage

To retrieve the Retail Sales data for PLN starting from the beginning of 2023: 

GET https://fxmacrodata.com/api/v1/announcements/pln/retail_sales?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY