Inventory Manager API · catalogs
Every catalog of the organization against one product
GET /products/{productId}/catalogs
Every catalog of the organization against one product: whether it lists the product, and the product's SKUs priced there as the catalog answers them.
Bounded by the organization's catalogs and the product's variants, never by what the catalogs list.
Access
Requires catalogs:read.
How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.
AI agent tool
Agents call this as catalog_product_catalogs (Catalog: Product catalogs), in the catalog toolset. It only reads.
Connecting an agent: AI agents.
Example
Retail stores its prices, GST included; wholesale takes the GST out, then 30 % off, rounded up to 95 cents.
curl -X GET 'https://inventory.getmanifold.io/products/prd_019cd54b-2e40-7921-ac50-698c7db3cbeb/catalogs' \
-H "Authorization: Bearer $MANIFOLD_TOKEN"const response = await fetch("https://inventory.getmanifold.io/products/prd_019cd54b-2e40-7921-ac50-698c7db3cbeb/catalogs", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();{
"productId": "prd_019cd54b-2e40-7921-ac50-698c7db3cbeb",
"catalogs": [
{
"catalog": {
"id": "cat_019cadd3-8524-7934-9ee3-29b896f71f80",
"name": "Default",
"currency": "AUD",
"status": "active",
"productCount": 2,
"priceCount": 3,
"pricing": {
"_tag": "manual"
},
"taxInclusive": "tenant-default",
"createdAt": "2026-03-02T09:14:06.500Z",
"updatedAt": "2026-04-02T05:50:12.000Z"
},
"listed": true,
"prices": [
{
"sku": "WIDGET-BLUE",
"priceCents": 2495,
"breaks": [
{
"minQuantity": 10,
"priceCents": 2195
}
]
},
{
"sku": "WIDGET-RED",
"priceCents": 2495
}
]
},
{
"catalog": {
"id": "cat_019e394f-ed80-7da2-823a-3ff13eb84f30",
"name": "Wholesale",
"currency": "AUD",
"status": "active",
"productCount": 2,
"priceCount": 0,
"pricing": {
"_tag": "auto",
"base": {
"_tag": "catalog",
"catalogId": "cat_019cadd3-8524-7934-9ee3-29b896f71f80"
},
"adjustment": {
"_tag": "discount",
"basisPoints": 3000
},
"rounding": [
{
"fromCents": 0,
"stepCents": 100,
"endingCents": 95
}
]
},
"taxInclusive": "exclusive",
"createdAt": "2026-05-18T04:20:00.000Z",
"updatedAt": "2026-05-18T04:31:45.000Z"
},
"listed": true,
"prices": [
{
"sku": "WIDGET-BLUE",
"priceCents": 1595,
"breaks": [
{
"minQuantity": 10,
"priceCents": 1495
}
],
"auto": true
},
{
"sku": "WIDGET-RED",
"priceCents": 1595,
"auto": true
}
]
}
]
}The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web
page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: inventory-manager.openapi.json. Base URL https://inventory.getmanifold.io.
Errors
Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.
401
| Refusal | What it means | What to do |
|---|---|---|
Unauthorized reason | The token is missing, expired or not one Manifold issued. | Get a fresh token and send the call again. |
TokenAlreadyUsed tokenId | A single-use app token was already spent. | Mint a new token for this call. |
402
| Refusal | What it means | What to do |
|---|---|---|
SubscriptionRequired status | The organization's subscription has lapsed, so writes are refused. | An owner settles billing. Reads still work meanwhile. |
403
| Refusal | What it means | What to do |
|---|---|---|
TenantRequired userId | The token names no organization. | Choose the organization, then get a new token. |
ScopeRequired required | The token's roles do not grant the scope this call needs. | Ask an owner or admin for a role that grants it. |
404
| Refusal | What it means | What to do |
|---|---|---|
ProductNotFound productId | No such record in this organization. | Check the id in the path or the body. |
409
| Refusal | What it means | What to do |
|---|---|---|
MirroredFromSource source | This area is fed by your source system until the organization goes live. | Make the change in the source system, or go live first. |
503
| Refusal | What it means | What to do |
|---|---|---|
RequestLogUnavailable tokenId, reason | The service could not record the request, so it did nothing. | Try again shortly. |
How refusals work everywhere: Errors.