List offers

List offers with status, marketplace and text filters.

GET/offersoffers:read

BEHAVIOR

The read respects the filters and returns only resources visible to the account linked to the key.

EFFECT

Does not change resources or trigger publication.

REPETITION

The operation is safe to repeat. On 429 or 5xx, use exponential backoff with jitter.

Request

limitinteger · queryQuantity per page.min 1 · max 100 · default 30optional

offsetinteger · queryPagination offset.min 0 · default 0optional

statusstring · queryCurated status.optional

marketplacestring · queryMarketplace.optional

querystring · querySearch by title or store.optional

AuthorizationBearer ach_live_...

Acceptapplication/json

Scopeoffers:read

Executable example

curl

curl 'https://achadu.com/api/v1/offers' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Response and errors

Every response includes request_id. Lists add pagination; mutable resources return the persisted state after the operation.

200 application/json

{
  "data": [
    {
      "id": "off_01J...",
      "marketplace": "amazon",
      "title": "Air fryer 5L",
      "url": "https://example.com/product",
      "price": 329.9,
      "currency": "BRL",
      "review_status": "pending",
      "created_at": "2026-08-31T18:20:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 30,
    "offset": 0,
    "has_more": false
  },
  "request_id": "req_01J..."
}

200Operation completed.

400Invalid parameter, body or transition.

401Missing, invalid, expired or revoked key.

402The account plan does not release this interface.

403A chave precisa do escopo offers:read.

404Feature does not exist in this account.

409The current state prevents this operation.

413The JSON body exceeds 128 KB.

429The 120 requests per minute window has been exceeded.

List offers

Request

Executable example

Response and errors

Related operations