Create a report — Pricefy API Reference
POST /v1/reports — Creates a scheduled report and returns it with its settings.
- `type` decides what the report exports and which product filters it accepts: Monitored URLs
(`monitored_urls`) and MAP Infringements (`map_infringements`) reports filter on the fields of
your monitored URLs, Price Timeline (`monitored_urls_details`) reports on the fields of your
catalog. List them with `GET /v1/reports/filter-options?type=…`.
- `delivery` needs at least one channel: email, or the web file (a fixed download link, returned
as `web_file_url`).
- Daily and hourly reports and the web file depend on your plan and are refused with `402`
otherwise (see Plan limits).
**When it is sent.** Weekly reports go out every Monday at 00:00 and daily reports every day at
09:00, in your account's time zone, or at `daily_time` (UTC) when you set it. Hourly reports go
out at the start of every hour. A new report starts at the next of those times, so a daily report
is first sent the next day, and a report arrives within the hour of its scheduled time.
`next_run_at` stays empty until the report has been scheduled. A disabled report is never sent.
Once your account holds 100 reports, creating another one returns `400` (`limit_reached`). After a
`502` or `503` the report may have been created anyway: check `GET /v1/reports` before retrying. Part of the Pricefy REST API.
Authentication: send the X-Api-Key header on every request. Base URL: https://api.pricefy.io.
OpenAPI specification ·
llms.txt ·
llms-full.txt
Merchant account, subscription and plan limits.
Store information and last import.
Merchant product catalog. Cursor-based pagination.
Competitor domains with price analysis.
URLs being monitored on each competitor, with stock and price diff.
Minimum Advertised Price rules and the resellers that breach them.
Dynamic pricing rules — create, read and update them, preview the suggested prices and apply them.
Scheduled reports — create, read and update them.
Alert rules (create, read and update them) and triggered alerts (price/stock variations).
The users of your account — invite colleagues, choose what each of them can see, suspend or remove them.
**Model Context Protocol** — same Pricefy API, exposed as MCP tools so Claude Desktop, Cursor, ChatGPT, Codex and the Claude CLI can call it natively. Streamable HTTP transport, JSON-RPC 2.0, dual auth (`X-Api-Key` **or** OAuth 2.1 Bearer), same per-merchant permissions as REST. 43 tools (26 read-only + 14 write + 3 destructive). See `POST /mcp` for the full catalog and the landing page for connection guides.
<img src="https://voyager.postman.com/logo/postman-logo-icon-orange.svg" alt="Postman" width="48" align="left" style="margin-right:12px"/>
The **complete Pricefy API collection** lives in the [public Pricefy Postman workspace](https://www.postman.com/pricefy/workspace/pricefy-api) — every endpoint, request body, query parameter and response example, pre-wired and ready to send. Use it to explore the API in Postman desktop / web, fork it into your own workspace, or run it as part of an automated test suite via Newman.
[](https://www.postman.com/pricefy/workspace/pricefy-api)
Alternatives:
- [Browse the workspace](https://www.postman.com/pricefy/workspace/pricefy-api) directly on postman.com
- [Download the collection JSON](/postman/collection.json) and import manually into Postman or Newman
