Quotes

A quote is our offer for a sourcing request: a price for each product and shipping options to your destination. When we change a quote we send a new version: it has a new id, the same number and a higher version, and the old version becomes SUPERSEDED with newerVersionId pointing to the new one. The list shows the version you can see of each quote number, newest quote number first.

Webhook quote.created tells you about every new quote and every new version. Accept or decline quotes in the portal; the API can't do that yet. Accepting writes the agreed prices into My products (the products then show price.kind AGREED and can be restocked) and moves the request on to DONE; a purchase order can follow. Declining the latest version sends the request back to IN_PROGRESS. There is no updatedSince here: use webhooks and GET, or read the first pages again to find new ones (the list is newest first). See Incremental sync.

Quote statuses

Value	Meaning
`AWAITING`	Awaiting your decision. Accept or decline it in the portal.
`UPDATING`	We are preparing a new version.
`SUPERSEDED`	Replaced by a newer version; `newerVersionId` points to it.
`ACCEPTED`	You accepted it.
`DECLINED`	You declined it.
`EXPIRED`	`validUntil` passed without a decision.

List quotes

GET /v1/quotes

The version you can see of each quote number. Newest quote number first.

Property	Value
URL	`https://api.rephut.com/v1/quotes`
Permission	`quotes:read`
Access	Read: counts towards the read limit and works while your account is on hold
Idempotency-Key	Not used
Success	200 OK

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page number. See Pagination. From 1 to 10,000. Default: `1`.

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer <your API key>`. See Authentication.

Response

200 with data, a list of objects with the fields below (up to one page), and meta with total, page, limit and pageCount. See Pagination.

Field	Type	Description
`id`	string	Quote id. Each version of a quote has its own id.
`number`	string	Our quote number; the same for every version.
`version`	integer	Version number, starting at 1.
`status`	string	Quote status. See Quote statuses. One of `AWAITING`, `UPDATING`, `SUPERSEDED`, `ACCEPTED`, `DECLINED`, `EXPIRED`.
`statusLabel`	string	English text for display. It may change; rely on the code next to it.
`issuedAt`	string (date-time)	When we sent this version.
`validUntil`	string (date-time)	The prices are valid until this time.
`itemCount`	integer	Number of products.
`currency`	string	Currency of every amount. Always `USD`.
`goodsCents`	integer	Total for the goods in US cents, without shipping.

Errors

Code	HTTP status	Meaning
`invalid_api_key`	401	The API key is missing, malformed, revoked or no longer valid.
`account_action_required`	403	Sign in to the portal and finish the required account steps first.
`api_not_enabled`	403	API access is not enabled for this account.
`insufficient_scope`	403	The API key does not have the permission this call needs.
`validation_failed`	422	The input is not valid. `details` lists each field and the reason.
`rate_limited`	429	Too many requests. Wait for the number of seconds in Retry-After.
`internal_error`	500	Unexpected error. Quote X-Request-Id when you contact support.

Handle errors by code. See Errors.

curlNode.jsPython

curl 'https://api.rephut.com/v1/quotes?page=1' \
  -H "Authorization: Bearer $FULFILLBOT_API_KEY"

const response = await fetch("https://api.rephut.com/v1/quotes?page=1", {
  headers: {
    Authorization: `Bearer ${process.env.FULFILLBOT_API_KEY}`,
  },
});
const result = await response.json();
console.log(response.status, result);

import os

import requests

response = requests.get(
    "https://api.rephut.com/v1/quotes?page=1",
    headers={
        "Authorization": f"Bearer {os.environ['FULFILLBOT_API_KEY']}",
    },
    timeout=30,
)
print(response.status_code, response.json())

Response 200

{
  "success": true,
  "data": [
    {
      "id": "cm3u2qt0e0001quo6h7j8k9l",
      "number": "Q2611100001",
      "version": 1,
      "status": "AWAITING",
      "statusLabel": "Awaiting your decision",
      "issuedAt": "2026-11-10T07:00:00.000Z",
      "validUntil": "2026-11-17T07:00:00.000Z",
      "itemCount": 1,
      "currency": "USD",
      "goodsCents": 72000
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "pageCount": 1
  }
}

Get a quote

GET /v1/quotes/{id}

Property	Value
URL	`https://api.rephut.com/v1/quotes/{id}`
Permission	`quotes:read`
Access	Read: counts towards the read limit and works while your account is on hold
Idempotency-Key	Not used
Success	200 OK

Path parameters

Name	Type	Description
`id`	string	Quote id, from `GET /v1/quotes` or `quoteId` of a request. An id that doesn't exist, isn't yours or isn't a valid id returns 404 `not_found`.