Marketplaces & Dates

Ask in plain language and your AI client fills these in for you. They are documented because a rejected request is nearly always one of the two — a marketplace code the server does not recognise, or a date in the wrong shape.

Marketplace codes

Codes are matched case-insensitively. Anything outside this set is rejected before the request reaches Propamp.

Region	Codes
North America	`US` `CA` `MX`
South America	`BR`
Europe	`UK` `IE` `DE` `FR` `IT` `ES` `NL` `BE` `PL` `SE` `CZ` `SK` `TR` `EU`
Asia-Pacific	`JP` `SG` `AU` `IN`
Middle East	`AE` `UAE` `SA`

Some tools take a single marketplace; others take a list. EU is a convenience aggregate rather than a storefront, so results for EU and for the individual European codes are not interchangeable.

ℹ️

A code being supported by the server does not mean you have data for it. You get data for the marketplaces your Seller Central account actually sells in and Propamp has synced.

Dates

Calendar dates use YYYY-MM-DD:


2026-08-25
2026-12-31

Dashboard tools that compare periods take ISO-8601 UTC date-times inside a period or periods object instead of plain calendar dates. Your client handles the difference; the practical effect is that dashboard comparisons are period-to-period rather than day-to-day.

Enumerated values

Field	Accepted values	Used by
`granularity`	`DAILY` `WEEKLY` `MONTHLY` `QUARTERLY` `YEARLY`	P&L
`scope`	`SINGLE` `THIS_AND_FOLLOWING` `SERIES`	Expense update and delete
`sortBy`	`balance` `velocity` `daysOfStock` `name`	Inventory and product lists
`sortDirection`	`asc` `desc`	Any paginated list

The expense scope values matter more than they look: expenses can be recurring, so updating or deleting one is a question of how many of the series you mean. SINGLE touches one occurrence, THIS_AND_FOLLOWING touches that one and everything after it, SERIES touches all of them.

Pagination

List tools take page and size, and most also accept a search string and marketplace or date filters. Responses carry the total count, so an assistant asked for “all” of something will page through rather than truncate silently.