Fulfillment Manager API · rates

What a cart would cost to send

POST /channels/{channelId}/rates

What a cart would cost to send, for a sales channel's checkout: any channel app calls it from its own checkout hook under its own token, and an app's token must be the app that provides the channel (403 ChannelNotYours); a person may call it to preview the rules.

The core dry-runs the organization's routing against current stock (the channel's first catalog deciding the policy), packs each site's parcel into its boxes (a line with no SKU, or one inventory does not hold, by its weightGrams), quotes every parcel from its site within CHECKOUT_RATES_BUDGET_MS (4 s), and offers the services every parcel shares, priced as their sum and coded <car_>:<service>, and — for a cart split across sites — the cheapest combination, coded combo:<chn_>, which names no single service (each parcel's is chosen at pack). Then the channel's rules apply — their money (a fixed markup, the free-shipping threshold, the fallback's price) is in the channel's own currency: a cart in another converts it at exchangeRate when the channel gave one, else at today's central-bank reference rate (each currency against the home currency, crossed), and leaves it out only when no rate converts it — never applied at face value. When no carrier answers in time, or every rate is ruled out, the fallback stands in (flat:<chn_>, fallback: true), or no rate at all without one. A SKU inventory has not weighed is weighed at the line's weightGrams; one nobody weighed makes the answer estimated, naming it in unweighed. A rate with an ETA — the carrier's, else the channel's transit days — carries delivery: the earliest and latest days it arrives, counted in business days (Monday to Friday; public holidays are not counted out) from its dispatch day under the channel's handling days and cut-off. Allowed while the organization is read-only. Appends nothing: a quote is asked of the carriers' apps and kept nowhere. No idempotency key: each call asks the carriers again and changes nothing.

Access

Requires shipping:read.

How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.

Retries

No idempotency key: each call asks the carriers again and changes nothing.

Why every write carries a key: Idempotency and retries.

Facts appended

None. This call records nothing in a journal.

What a fact is: Facts and the journal.

AI agent tool

No agent tool. a channel app's checkout callback under its own token; people preview in Settings › Shipping

Connecting an agent: AI agents.

Example

curl -X POST 'https://fulfillment.getmanifold.io/channels/chn_01a0f6b5-5030-7cc1-8e46-4e5f60718293/rates' \
  -H "Authorization: Bearer $MANIFOLD_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "lines": [
    {
      "sku": "MUG-SPECKLE",
      "quantity": 4,
      "priceCents": 2400
    }
  ],
  "to": {
    "address1": "20 George Street",
    "city": "Sydney",
    "province": "New South Wales",
    "provinceCode": "NSW",
    "zip": "2000",
    "countryCode": "AU"
  },
  "currency": "AUD"
}'

const response = await fetch("https://fulfillment.getmanifold.io/channels/chn_01a0f6b5-5030-7cc1-8e46-4e5f60718293/rates", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "lines": [
      {
        "sku": "MUG-SPECKLE",
        "quantity": 4,
        "priceCents": 2400
      }
    ],
    "to": {
      "address1": "20 George Street",
      "city": "Sydney",
      "province": "New South Wales",
      "provinceCode": "NSW",
      "zip": "2000",
      "countryCode": "AU"
    },
    "currency": "AUD"
  }),
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();

{
  "lines": [
    {
      "sku": "MUG-SPECKLE",
      "quantity": 4,
      "priceCents": 2400
    }
  ],
  "to": {
    "address1": "20 George Street",
    "city": "Sydney",
    "province": "New South Wales",
    "provinceCode": "NSW",
    "zip": "2000",
    "countryCode": "AU"
  },
  "currency": "AUD"
}

{
  "rates": [
    {
      "code": "car_01a0f6b3-2d00-7a91-9b13-e8f90a1b2c3d:7E55~chq_01a15a60-6140-7dd1-9f57-5f60718293a4",
      "title": "Standard shipping",
      "priceCents": 1599,
      "carrierPriceCents": 1395,
      "currency": "AUD",
      "etaDays": {
        "min": 2,
        "max": 5
      },
      "delivery": {
        "earliest": "2026-10-23",
        "latest": "2026-10-28"
      },
      "carrierAccountId": "car_01a0f6b3-2d00-7a91-9b13-e8f90a1b2c3d",
      "service": {
        "code": "7E55",
        "name": "Parcel Post",
        "carrier": "Australia Post"
      }
    },
    {
      "code": "car_01a0f6b3-2d00-7a91-9b13-e8f90a1b2c3d:7J55~chq_01a15a60-6140-7dd1-9f57-5f60718293a4",
      "title": "Express shipping",
      "priceCents": 2199,
      "carrierPriceCents": 1980,
      "currency": "AUD",
      "etaDays": {
        "min": 1,
        "max": 2
      },
      "delivery": {
        "earliest": "2026-10-22",
        "latest": "2026-10-23"
      },
      "carrierAccountId": "car_01a0f6b3-2d00-7a91-9b13-e8f90a1b2c3d",
      "service": {
        "code": "7J55",
        "name": "Express Post",
        "carrier": "Australia Post"
      }
    }
  ],
  "quoteId": "chq_01a15a60-6140-7dd1-9f57-5f60718293a4",
  "fallback": false,
  "estimated": false,
  "unweighed": []
}

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: fulfillment-manager.openapi.json. Base URL https://fulfillment.getmanifold.io.

Errors

Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.

401

402

403

404

409

502

503

How refusals work everywhere: Errors.