Median API: read-only reports preview

Request access to a narrow REST reference for company financial reports.

By Jacob Sheldon. Reviewed October 9, 2026

Request report API access

This preview covers six company-scoped, read-only report endpoints. Ask Median to confirm REST access and provision a company-specific API key with the reports:read scope before building an integration.

The downloadable OpenAPI file lists the routes and schemas. Some reports, including aging, depend on enabled company features.

Base URL

text

https://api.medianfi.com/api/v1

Send an authenticated request

Send the provisioned key in the X-API-Key header over HTTPS. The REST API key is separate from customer MCP OAuth.

bash

curl --get "https://api.medianfi.com/api/v1/companies/<companyId>/reports/pl" \
  --data-urlencode "startDate=2026-01-01" \
  --data-urlencode "endDate=2026-03-31" \
  --header "X-API-Key: <provisioned-key>"

Included reports

P&L, balance sheet, and cash flow.
General ledger.
Accounts receivable and accounts payable aging, where enabled.

Endpoint inputs, outputs, and OpenAPI download

Access boundaries

This credential permits reports:read access for its company.
Do not use an MCP OAuth token as a REST credential.

Back to Developer docs