Skip to main content
GET
Get Macro Report
This is a synchronous endpoint - results are returned immediately without job polling.

Response Formats

JSON Format (default)

When format=json, the response includes the report file URL:
When include_content=true, the content field contains the full report data instead of null.

PDF Format

When format=pdf, the response includes the PDF URL:

List Available Markets

To get a list of all markets with available reports:
The response above is illustrative. Coverage changes as markets are added, so call this endpoint for the current list rather than hard-coding market names.

Example: Fetch Report with Content

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

market
string
required

Market name (e.g., 'United States', 'Japan')

format
string
default:json

Response format: 'json' or 'pdf'

include_content
boolean
default:false

For JSON: include actual report content

date
string | null

Report date (YYYY-MM-DD). Omit for latest.

Response

Successful Response

Last modified on September 21, 2026