{
  "info": {
    "name": "Avrix Seller API",
    "description": "**Avrix Seller API** — OpenAPI contract v2026-09-01. Public guides: https://docs.avrix.io/seller-api/quickstart\n\nEvery Seller API operation appears below in the same order and with the same parameters as the OpenAPI spec. Optional query parameters are listed as **disabled rows** so you can see and enable them without retyping names. Mutating requests (POST/PATCH/PUT/DELETE) are marked **disabled by default** — enable them in Postman only when you are on a sandbox that you are willing to change state on.\n\n### Setup\n1. Import the Production environment (or create one) with `baseUrl` = `https://api.avrix.io`.\n2. Set `apiKey` to a key from **Settings → Integrations → API Keys** in the Avrix console. Use a **sandbox** key for everyday testing; use a **production** key only after go-live. The key selects the environment — not a different host.\n3. Select that environment from the top-right dropdown.\n\n### Authentication\nAll requests inherit bearer auth from the collection: `Authorization: Bearer {{apiKey}}`. Health is the only public route that does not require auth.\n\n### Idempotency\nEvery request whose operation requires an `Idempotency-Key` header (the order, key, refund, dispute, access-proposal and webhook-registration writes) ships with `Idempotency-Key: {{$guid}}` pre-wired. The key is 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`. **Retries with the same key MUST resend the same canonical JSON body** — mismatch returns **409 `IDEMPOTENCY_KEY_MISMATCH`** with the current body's SHA-256 in `details.requestBodyHash`.\n\n### Error envelope\nAll 4xx/5xx responses share the same JSON shape: `{ code, message, timestamp, recoverable, hint, doc_url, requestId, details? }`. Validation failures are **422** with `code: VALIDATION_FAILED` and `details.validationTarget` ∈ { `query`, `json_body`, `path` } plus `details.issues[].{ field, message }`. 403 bodies may include `details.missingScope` / `details.requiredScopes`.\n\n### Observability\nResponses include `X-Api-Version: 1`, `X-Avrix-Api-Version` and `X-Request-Id`; every response to a request counted against a rate limit also carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. On cache hits you may see `X-Cache: HIT|MISS|BYPASS`. On idempotent replays: `Idempotency-Replayed: true`. On rate-limit: `Retry-After` (seconds). The Postman console logs these automatically via this collection's test script.\n\n### Sandbox vs production\nDeployments enforce an `environment` (`production` or `sandbox`) on every API key. Mixing a sandbox key with a production deployment (or vice versa) returns **401 `KEY_ENVIRONMENT_MISMATCH`**. See https://docs.avrix.io/seller-api/sandbox.\n\n### Returns are quarantined\n`POST /keys/return` quarantines delivered keys — they are **not** recycled into the available pool. Operators re-issue manually after publisher confirmation. See https://docs.avrix.io/seller-api/refunds-returns.\n\n### Public docs\n- [Quickstart (30 min)](https://docs.avrix.io/seller-api/quickstart) — golden path to first order\n- [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) — scopes, call order, idempotency\n- [Catalog sync & sellability](https://docs.avrix.io/seller-api/catalog-and-allocations) — allocations are checkout authority\n- [Scope matrix](https://docs.avrix.io/seller-api/scopes) — authoritative per-endpoint scopes\n- [Error playbook](https://docs.avrix.io/seller-api/errors) — every `code`, when it fires, and how to recover\n- [Sandbox](https://docs.avrix.io/seller-api/sandbox) — base URLs, magic SKUs, 401/403 triage\n- [Refunds & returns](https://docs.avrix.io/seller-api/refunds-returns) — quarantine behaviour (Avrix never refunds your PSP)\n- [Webhooks](https://docs.avrix.io/seller-api/webhooks) — HMAC signing, event types",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Auto-seed orderReference with a per-send UUID when empty so the",
          "// Create Order request is idempotent on replay but unique each new",
          "// Send.",
          "if (!pm.collectionVariables.get('orderReference')) {",
          "  pm.collectionVariables.set('orderReference', 'store-order-' + (new Date()).toISOString().replace(/[:.]/g, '-'));",
          "}"
        ]
      }
    },
    {
      "listen": "test",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Collection-level teardown: log top-level observability headers",
          "// on every response so partners can grep the Postman console when",
          "// asking support about a request they just made.",
          "const rid = pm.response.headers.get('X-Request-Id');",
          "if (rid) { console.log('[' + pm.info.requestName + '] X-Request-Id:', rid); }",
          "const rep = pm.response.headers.get('Idempotency-Replayed');",
          "if (rep) { console.log('[' + pm.info.requestName + '] Idempotency-Replayed:', rep); }"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.avrix.io",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "string"
    },
    {
      "key": "productId",
      "value": "",
      "type": "string"
    },
    {
      "key": "skuId",
      "value": "",
      "type": "string"
    },
    {
      "key": "skuCode",
      "value": "SANDBOX-ALWAYS-001",
      "type": "string"
    },
    {
      "key": "countryCode",
      "value": "US",
      "type": "string"
    },
    {
      "key": "expectedUnitPriceCents",
      "value": "",
      "type": "string"
    },
    {
      "key": "allocationId",
      "value": "",
      "type": "string"
    },
    {
      "key": "keyId",
      "value": "",
      "type": "string"
    },
    {
      "key": "webhookId",
      "value": "",
      "type": "string"
    },
    {
      "key": "deliveryId",
      "value": "",
      "type": "string"
    },
    {
      "key": "shareId",
      "value": "",
      "type": "string"
    },
    {
      "key": "responseId",
      "value": "",
      "type": "string"
    },
    {
      "key": "orderReference",
      "value": "",
      "type": "string"
    },
    {
      "key": "orderReadableId",
      "value": "",
      "type": "string"
    },
    {
      "key": "checkoutHoldId",
      "value": "",
      "type": "string"
    },
    {
      "key": "exportId",
      "value": "",
      "type": "string"
    },
    {
      "key": "freezeId",
      "value": "",
      "type": "string"
    },
    {
      "key": "transactionId",
      "value": "",
      "type": "string"
    },
    {
      "key": "invoiceId",
      "value": "",
      "type": "string"
    },
    {
      "key": "reportId",
      "value": "",
      "type": "string"
    },
    {
      "key": "attestId",
      "value": "",
      "type": "string"
    },
    {
      "key": "fulfillmentId",
      "value": "",
      "type": "string"
    },
    {
      "key": "holdId",
      "value": "",
      "type": "string"
    },
    {
      "key": "reservationId",
      "value": "",
      "type": "string"
    },
    {
      "key": "orderId",
      "value": "",
      "type": "string"
    },
    {
      "key": "connectionId",
      "value": "",
      "type": "string"
    },
    {
      "key": "refundId",
      "value": "",
      "type": "string"
    },
    {
      "key": "code",
      "value": "",
      "type": "string"
    },
    {
      "key": "requestId",
      "value": "",
      "type": "string"
    },
    {
      "key": "returnRequestId",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Health",
      "description": "Auth-free uptime check. Use this first when triaging outages — the body includes `redisConfigured` so you can see whether the cache/idempotency fast path is live.",
      "item": [
        {
          "name": "GET — Health check (with sub-component status)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/health",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "health"
              ]
            },
            "description": "**Health check (with sub-component status)**\n\nUptime + per-component status. Auth optional. Returns 503 only when the **db** probe is degraded; otherwise 200. The `components` object reports `db`, `redis`, `qstash`, `webhookDelivery`, `outboxJobs`, `catalogIndex` and `consumerGeo` independently with `status` (`ok` / `degraded` / `unconfigured`), `latencyMs`, and an optional `message` field. The top-level `status` is `degraded` (still HTTP 200, with `degradedReasons`) when a queue is behind, QStash is unconfigured in production, or the deployment has no (or stale) buyer geolocation data (`consumerGeo`). `catalogIndex` never downgrades the top-level status. The legacy `redisConfigured` boolean is preserved for backwards compatibility. Note: Unlike other endpoints, health does not wrap the response in a `data` object.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500, 503\n\n**Path:** `GET /api/seller/v1/health`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 API is operational",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/health",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "health"
                  ]
                },
                "description": "**Health check (with sub-component status)**\n\nUptime + per-component status. Auth optional. Returns 503 only when the **db** probe is degraded; otherwise 200. The `components` object reports `db`, `redis`, `qstash`, `webhookDelivery`, `outboxJobs`, `catalogIndex` and `consumerGeo` independently with `status` (`ok` / `degraded` / `unconfigured`), `latencyMs`, and an optional `message` field. The top-level `status` is `degraded` (still HTTP 200, with `degradedReasons`) when a queue is behind, QStash is unconfigured in production, or the deployment has no (or stale) buyer geolocation data (`consumerGeo`). `catalogIndex` never downgrades the top-level status. The legacy `redisConfigured` boolean is preserved for backwards compatibility. Note: Unlike other endpoints, health does not wrap the response in a `data` object.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500, 503\n\n**Path:** `GET /api/seller/v1/health`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"status\": \"ok\",\n  \"timestamp\": \"2026-11-02T09:30:00Z\",\n  \"version\": \"1\",\n  \"redisConfigured\": true,\n  \"checkDurationMs\": 1,\n  \"components\": {\n    \"db\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"redis\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"qstash\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"catalogIndex\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"webhookDelivery\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"outboxJobs\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"consumerGeo\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"orderPath\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"sandbox\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    },\n    \"checkoutHold\": {\n      \"status\": \"ok\",\n      \"latencyMs\": 1,\n      \"message\": \"Example text.\",\n      \"lastUpdated\": \"2026-11-02T09:30:00Z\",\n      \"ageSeconds\": 300,\n      \"publisher\": true,\n      \"receiver\": true,\n      \"pending\": 1,\n      \"buffered\": 1,\n      \"dueLagSeconds\": 300,\n      \"failedLast24h\": 1,\n      \"oldestPendingAgeSeconds\": 300\n    }\n  },\n  \"backlog\": {\n    \"webhookDeliveriesPending\": 1,\n    \"outboxJobsPending\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/health",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "health"
                  ]
                },
                "description": "**Health check (with sub-component status)**\n\nUptime + per-component status. Auth optional. Returns 503 only when the **db** probe is degraded; otherwise 200. The `components` object reports `db`, `redis`, `qstash`, `webhookDelivery`, `outboxJobs`, `catalogIndex` and `consumerGeo` independently with `status` (`ok` / `degraded` / `unconfigured`), `latencyMs`, and an optional `message` field. The top-level `status` is `degraded` (still HTTP 200, with `degradedReasons`) when a queue is behind, QStash is unconfigured in production, or the deployment has no (or stale) buyer geolocation data (`consumerGeo`). `catalogIndex` never downgrades the top-level status. The legacy `redisConfigured` boolean is preserved for backwards compatibility. Note: Unlike other endpoints, health does not wrap the response in a `data` object.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500, 503\n\n**Path:** `GET /api/seller/v1/health`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — OAuth2 client_credentials token",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/oauth/token",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "oauth",
                "token"
              ]
            },
            "description": "**OAuth2 client_credentials token**\n\nMint a short-lived Bearer token (`avrix_oat_*`, about 3600 seconds) for a **seller API key**. The key is the OAuth client: `client_id` is the key's id (uuid) and `client_secret` is the key's secret. Also served at `/api/seller/v1/oauth/token`. Disabled when OAuth token minting is not enabled on the deployment (**501**).\n\n**Request.** `grant_type=client_credentials`, as a form-encoded body (`application/x-www-form-urlencoded`, the standard client-credentials call) or as JSON (the original call, unchanged). Send the client credentials either with HTTP Basic (`Authorization: Basic base64(client_id:client_secret)`) or as `client_id` and `client_secret` in the body, not both: a request that sends both is refused with `422` on a form body, and on JSON from contract date `2026-12-01` (before that date a JSON body that carries `client_secret` is read as always and an `Authorization` header is ignored). A `scope` parameter is ignored.\n\n**Response.** `access_token`, `token_type` (`Bearer`), `expires_in` and `scope` (the key's scopes, space-separated; the token carries exactly these), with `Cache-Control: no-store` and `Pragma: no-cache`.\n\n**Errors** keep the Avrix error body and status codes (`401` for a refused client, `422` for a malformed request, not the `400` of RFC 6749) and add `error_description`. `error` holds the RFC 6749 error code (`invalid_client`, `invalid_request`, `unsupported_grant_type`, `unauthorized_client`, `temporarily_unavailable`, `server_error`) on form-encoded requests and on JSON from contract date `2026-12-01`; on JSON before that date it keeps the message, as before. A refused HTTP Basic client also gets `WWW-Authenticate: Basic`.\n\n**Privacy:** treat `client_secret` like a password: never log or persist it.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 413, 422, 429, 500, 501, 503, 504\n\n**Path:** `POST /api/seller/oauth/token`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"grant_type\": \"client_credentials\",\n  \"client_id\": \"00000000-0000-4000-8000-000000000011\",\n  \"client_secret\": \"example_secret\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 access_token issued",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/oauth/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "oauth",
                    "token"
                  ]
                },
                "description": "**OAuth2 client_credentials token**\n\nMint a short-lived Bearer token (`avrix_oat_*`, about 3600 seconds) for a **seller API key**. The key is the OAuth client: `client_id` is the key's id (uuid) and `client_secret` is the key's secret. Also served at `/api/seller/v1/oauth/token`. Disabled when OAuth token minting is not enabled on the deployment (**501**).\n\n**Request.** `grant_type=client_credentials`, as a form-encoded body (`application/x-www-form-urlencoded`, the standard client-credentials call) or as JSON (the original call, unchanged). Send the client credentials either with HTTP Basic (`Authorization: Basic base64(client_id:client_secret)`) or as `client_id` and `client_secret` in the body, not both: a request that sends both is refused with `422` on a form body, and on JSON from contract date `2026-12-01` (before that date a JSON body that carries `client_secret` is read as always and an `Authorization` header is ignored). A `scope` parameter is ignored.\n\n**Response.** `access_token`, `token_type` (`Bearer`), `expires_in` and `scope` (the key's scopes, space-separated; the token carries exactly these), with `Cache-Control: no-store` and `Pragma: no-cache`.\n\n**Errors** keep the Avrix error body and status codes (`401` for a refused client, `422` for a malformed request, not the `400` of RFC 6749) and add `error_description`. `error` holds the RFC 6749 error code (`invalid_client`, `invalid_request`, `unsupported_grant_type`, `unauthorized_client`, `temporarily_unavailable`, `server_error`) on form-encoded requests and on JSON from contract date `2026-12-01`; on JSON before that date it keeps the message, as before. A refused HTTP Basic client also gets `WWW-Authenticate: Basic`.\n\n**Privacy:** treat `client_secret` like a password: never log or persist it.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 413, 422, 429, 500, 501, 503, 504\n\n**Path:** `POST /api/seller/oauth/token`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"grant_type\": \"client_credentials\",\n  \"client_id\": \"00000000-0000-4000-8000-000000000011\",\n  \"client_secret\": \"example_secret\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"access_token\": \"example_accesstoken\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 1\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/oauth/token",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "oauth",
                    "token"
                  ]
                },
                "description": "**OAuth2 client_credentials token**\n\nMint a short-lived Bearer token (`avrix_oat_*`, about 3600 seconds) for a **seller API key**. The key is the OAuth client: `client_id` is the key's id (uuid) and `client_secret` is the key's secret. Also served at `/api/seller/v1/oauth/token`. Disabled when OAuth token minting is not enabled on the deployment (**501**).\n\n**Request.** `grant_type=client_credentials`, as a form-encoded body (`application/x-www-form-urlencoded`, the standard client-credentials call) or as JSON (the original call, unchanged). Send the client credentials either with HTTP Basic (`Authorization: Basic base64(client_id:client_secret)`) or as `client_id` and `client_secret` in the body, not both: a request that sends both is refused with `422` on a form body, and on JSON from contract date `2026-12-01` (before that date a JSON body that carries `client_secret` is read as always and an `Authorization` header is ignored). A `scope` parameter is ignored.\n\n**Response.** `access_token`, `token_type` (`Bearer`), `expires_in` and `scope` (the key's scopes, space-separated; the token carries exactly these), with `Cache-Control: no-store` and `Pragma: no-cache`.\n\n**Errors** keep the Avrix error body and status codes (`401` for a refused client, `422` for a malformed request, not the `400` of RFC 6749) and add `error_description`. `error` holds the RFC 6749 error code (`invalid_client`, `invalid_request`, `unsupported_grant_type`, `unauthorized_client`, `temporarily_unavailable`, `server_error`) on form-encoded requests and on JSON from contract date `2026-12-01`; on JSON before that date it keeps the message, as before. A refused HTTP Basic client also gets `WWW-Authenticate: Basic`.\n\n**Privacy:** treat `client_secret` like a password: never log or persist it.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 413, 422, 429, 500, 501, 503, 504\n\n**Path:** `POST /api/seller/oauth/token`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"grant_type\": \"client_credentials\",\n  \"client_id\": \"00000000-0000-4000-8000-000000000011\",\n  \"client_secret\": \"example_secret\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                },
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "First order in 30 minutes",
      "description": "Run **top to bottom**. Set `apiKey` (environment). **02 List Products** chains a *sellable* SKU automatically (prefers the preconfigured `skuCode` when it is sellable, otherwise the first product with `sharedSkus[].sellable === true`) — negative-path fixtures are never selected. Set `orderReference` to your store's order id. **05 Preview Order** chains `expectedUnitPriceCents` for **06 Create Order**. See https://docs.avrix.io/seller-api/quickstart.",
      "item": [
        {
          "name": "01 List Partners",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional correlation id"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/partners",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "partners"
              ]
            },
            "description": "Confirms at least one publisher is connected to your seller company. Requires `seller:products:read`."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const partners = pm.response.json().data || [];",
                  "console.log('Connected partners:', partners.length);"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "02 List Products",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "en-US,en;q=0.9",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products?limit=20",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "20",
                  "description": "Page size 1–100"
                }
              ]
            },
            "description": "Lists catalog products from connected partners. Chains `productId` + `skuCode` from a SKU with `sharedSkus[].sellable === true` so the golden path never lands on a negative-path fixture."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const rows = pm.response.json().data || [];",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "// Deterministic golden-path selection: only chain SKUs that are",
                  "// actually sellable. Prefer the preconfigured skuCode when present",
                  "// and sellable; otherwise take the first sellable shared SKU.",
                  "const sellableOf = (p) => (p.sharedSkus || []).filter((s) => s && s.sellable === true);",
                  "const preconfigured = pm.variables.get('skuCode');",
                  "let product = rows.find((p) => sellableOf(p).some((s) => s.skuCode === preconfigured));",
                  "let sku = product ? sellableOf(product).find((s) => s.skuCode === preconfigured) : null;",
                  "if (!product) {",
                  "  product = rows.find((p) => sellableOf(p).length > 0) || null;",
                  "  sku = product ? sellableOf(product)[0] : null;",
                  "}",
                  "pm.test('found a sellable SKU to chain', () => {",
                  "  pm.expect(sku, 'no sellable sharedSkus on this page — check shares/allocations (see /allocations)').to.be.ok;",
                  "});",
                  "pm.test('chained SKU is not a negative-path fixture', () => {",
                  "  const code = sku ? sku.skuCode : preconfigured;",
                  "  pm.expect(code || '').to.not.match(/^SANDBOX-(NOSHARE|NOALLOC|NOKEYS|LIFECYCLE|PREORDER)-/);",
                  "});",
                  "if (product && sku) {",
                  "  setVar('productId', product.id);",
                  "  setVar('skuCode', sku.skuCode);",
                  "  if (sku.id) setVar('skuId', sku.id);",
                  "  console.log('golden chain:', product.id, sku.skuCode);",
                  "} else if (!rows.length) {",
                  "  console.warn('No products — seed data or check partner connections.');",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "03 Get Product Detail",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "en-US,en;q=0.9",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products/:productId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products",
                ":productId"
              ],
              "variable": [
                {
                  "key": "productId",
                  "value": "{{productId}}",
                  "description": "From step 02"
                }
              ]
            },
            "description": "Returns editions, releases, SKUs and pricing for the chained product. `skuCode` stays on the sellable SKU chosen in step 02 — this step only resolves its `skuId`."
          },
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"productId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const body = pm.response.json();",
                  "const editions = body?.data?.editions || [];",
                  "const skus = editions.flatMap(e => e.releases || []).flatMap(r => r.skus || []);",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "// Never overwrite the sellable skuCode chosen in step 02 — only",
                  "// resolve its skuId from the detail payload.",
                  "const chosen = pm.variables.get('skuCode');",
                  "const match = skus.find((s) => (s.skuCode || s.sku_code) === chosen);",
                  "if (match) {",
                  "  setVar('skuId', match.id || match.skuId || '');",
                  "  console.log('skuId resolved for', chosen, ':', match.id);",
                  "} else {",
                  "  console.warn('Chosen skuCode not in detail payload — keeping', chosen);",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "04 Check Availability",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/availability?skuCode={{skuCode}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "availability"
              ],
              "query": [
                {
                  "key": "skuCode",
                  "value": "{{skuCode}}",
                  "description": "Provide skuCode or skuId (single mode)"
                }
              ]
            },
            "description": "Returns allocation headroom and inventory for the SKU. `available = min(allocationRemaining, inventoryAvailable)`."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const d = pm.response.json().data;",
                  "if (d) console.log('available:', d.available, '| allocation:', d.allocationRemaining, '| inventory:', d.inventoryAvailable);"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "05 Preview Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "preview"
              ]
            },
            "description": "Non-binding checkout estimate. Chains `expectedUnitPriceCents` into **06 Create Order** for API allocations."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const body = pm.response.json();",
                  "pm.test('canFulfill', () => pm.expect(body?.data?.canFulfill).to.eql(true));",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "const unitPrice = body?.data?.lines?.[0]?.unitPriceCents ?? body?.data?.unitPriceCents;",
                  "if (unitPrice != null) {",
                  "  setVar('expectedUnitPriceCents', String(unitPrice));",
                  "  console.log('expectedUnitPriceCents set:', unitPrice);",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "06 Create Order (disabled)",
          "disabled": true,
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Retries with the same key + body replay the stored response"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\",\n  \"expectedUnitPriceCents\": {{expectedUnitPriceCents}},\n  \"orderReference\": \"{{orderReference}}\",\n  \"customerReference\": \"checkout-line-1\",\n  \"metadata\": { \"cartId\": \"cart_example\", \"channel\": \"web\" },\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"{{countryCode}}\",\n    \"currencyCode\": \"USD\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 5999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 0,\n    \"salesTaxRatePercent\": 0,\n    \"customerType\": \"b2c\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"pi_example_123\",\n    \"checkoutSessionId\": \"cs_example_abc\",\n    \"consumerIp\": \"8.8.8.8\",\n    \"salesChannel\": \"web\",\n    \"lineIndex\": 0\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ]
            },
            "description": "Enable only on a sandbox you are willing to mutate. Run **05 Preview Order** first. Set `orderReference` before Send. Reuse the same `Idempotency-Key` when retrying."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "if (pm.response.code === 0) { return; }",
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const body = pm.response.json();",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "if (body?.data?.orderReadableId) {",
                  "  setVar('orderReadableId', body.data.orderReadableId);",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "07 Get Order by Reference",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders?orderReference={{orderReference}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ],
              "query": [
                {
                  "key": "orderReference",
                  "value": "{{orderReference}}",
                  "description": "Store order id (use exactly one of orderReference or orderReadableId)"
                },
                {
                  "key": "orderReadableId",
                  "value": "{{orderReadableId}}",
                  "description": "Avrix ord_… id (disable orderReference when using)",
                  "disabled": true
                }
              ]
            },
            "description": "Reconcile key pulls and pre-order reservations for your order. Provide exactly one of `orderReference` or `orderReadableId`."
          }
        }
      ]
    },
    {
      "name": "Store profile A — minimal checkout",
      "description": "Profile A minimal store path per [Store integration profiles](https://docs.avrix.io/seller-api/store-profiles): whoami → allocations (sellable) → preview → order. Default `skuCode` is `SANDBOX-ALWAYS-001`. Set `apiKey` and `orderReference`. Run **03 Preview Order** before enabling **04 Create Order**.",
      "item": [
        {
          "name": "01 Whoami",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/whoami",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "whoami"
              ]
            },
            "description": "Confirm scopes, BMA (`hasActiveBma`), lightweight `integrationReadiness`, and `capabilities` before checkout. Default path is fast; add `?diagnostics=1` only when debugging missing shares/pricing."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const me = pm.response.json()?.data;",
                  "pm.test('seller persona', () => pm.expect(me?.persona).to.eql('seller'));"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "02 List Allocations (sellable)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations?limit=50",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size"
                }
              ]
            },
            "description": "Checkout authority. Chains a `sellable === true` row into `skuCode` / `allocationId` / `expectedUnitPriceCents` — the preconfigured `skuCode` when it is sellable, otherwise the first sellable `api`-model row (wholesale rows need cleared payment and are never chained here). Catalog list alone is not enough — see [Catalog sync & sellability](https://docs.avrix.io/seller-api/catalog-and-allocations)."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const rows = pm.response.json()?.data || [];",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "// Deterministic selection: rows come newest-first, so 'first sellable'",
                  "// would follow whatever fixture was provisioned last (a wholesale grant",
                  "// or a lifecycle-toggling one). Prefer the preconfigured skuCode when it",
                  "// is sellable; otherwise the first sellable api-model row.",
                  "const preconfigured = pm.variables.get('skuCode');",
                  "const sellableRows = rows.filter((r) => r && r.sellable === true);",
                  "const sellable =",
                  "  sellableRows.find((r) => r.skuCode === preconfigured) ||",
                  "  sellableRows.find((r) => r.businessModel === 'api') ||",
                  "  null;",
                  "if (sellable) {",
                  "  if (sellable.skuCode) setVar('skuCode', sellable.skuCode);",
                  "  if (sellable.allocationId || sellable.id) setVar('allocationId', sellable.allocationId || sellable.id);",
                  "  const price = sellable.pricePerKeyCents ?? sellable.unitPriceCents;",
                  "  if (price != null && price !== '') setVar('expectedUnitPriceCents', String(price));",
                  "  console.log('sellable skuCode set:', sellable.skuCode);",
                  "} else {",
                  "  console.warn('No sellable api-model allocation — keeping collection skuCode (default SANDBOX-ALWAYS-001).');",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "03 Preview Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "preview"
              ]
            },
            "description": "Gate your PSP charge on `canFulfill === true`. Chains `expectedUnitPriceCents` for **04 Create Order**."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const body = pm.response.json();",
                  "pm.test('canFulfill', () => pm.expect(body?.data?.canFulfill).to.eql(true));",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "const unitPrice = body?.data?.lines?.[0]?.unitPriceCents ?? body?.data?.unitPriceCents;",
                  "if (unitPrice != null) {",
                  "  setVar('expectedUnitPriceCents', String(unitPrice));",
                  "}"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "04 Create Order (disabled)",
          "disabled": true,
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Reuse when retrying the same checkout"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\",\n  \"expectedUnitPriceCents\": {{expectedUnitPriceCents}},\n  \"orderReference\": \"{{orderReference}}\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"{{countryCode}}\",\n    \"currencyCode\": \"USD\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 5999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 0,\n    \"salesTaxRatePercent\": 0,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"pi_profile_a_example\",\n    \"checkoutSessionId\": \"cs_profile_a_example\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ]
            },
            "description": "Enable only on sandbox. Run **03 Preview Order** first. Set `orderReference` before Send."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "if (pm.response.code === 0) { return; }",
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));"
                ],
                "type": "text/javascript"
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Store profile B — production checkout with hold",
      "description": "Profile B, the golden path per [Store integration profiles](https://docs.avrix.io/seller-api/store-profiles): whoami (holds configured) → preview → checkout hold → charge the buyer → order with `checkoutHoldId`. Default `skuCode` is `SANDBOX-ALWAYS-001`. Set `apiKey` and `orderReference`; **04 Create Order** is disabled until you enable it on sandbox.",
      "item": [
        {
          "name": "01 Whoami (holds configured)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/whoami",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "whoami"
              ]
            }
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const caps = pm.response.json()?.data?.capabilities || {};",
                  "pm.test('checkout holds configured (Profile B requires them)', () => {",
                  "  pm.expect(caps.checkoutHoldConfigured, 'checkoutHoldConfigured').to.eql(true);",
                  "  pm.expect(caps.checkoutHoldEnabled, 'checkoutHoldEnabled').to.eql(true);",
                  "});"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "02 Preview Order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"{{countryCode}}\",\n    \"consumerIp\": \"8.8.8.8\",\n    \"currencyCode\": \"USD\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 5999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 0,\n    \"salesTaxRatePercent\": 0,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"pi_profile_b_example\",\n    \"checkoutSessionId\": \"cs_profile_b_example\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "preview"
              ]
            },
            "description": "Gate the charge on `canFulfill === true`; chains `expectedUnitPriceCents`."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "const body = pm.response.json();",
                  "pm.test('canFulfill', () => pm.expect(body?.data?.canFulfill).to.eql(true));",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "const unitPrice = body?.data?.lines?.[0]?.unitPriceCents ?? body?.data?.unitPriceCents;",
                  "if (unitPrice != null) setVar('expectedUnitPriceCents', String(unitPrice));"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "03 Checkout Hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"orderReference\": \"{{orderReference}}\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"{{countryCode}}\",\n    \"consumerIp\": \"8.8.8.8\",\n    \"currencyCode\": \"USD\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 5999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 0,\n    \"salesTaxRatePercent\": 0,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"pi_profile_b_example\",\n    \"checkoutSessionId\": \"cs_profile_b_example\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "hold"
              ]
            },
            "description": "Hold the stock while the buyer pays. A 412 `CHECKOUT_HOLD_DISABLED` or 503 means this deployment cannot serve Profile B: stop, do not fall back to preview → order."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "pm.test('hold granted (no silent fallback)', () => pm.expect(pm.response.code).to.eql(200));",
                  "function setVar(k, v) {",
                  "  pm.environment.set(k, v);",
                  "  pm.collectionVariables.set(k, v);",
                  "}",
                  "const id = pm.response.json()?.data?.checkoutHoldId ?? pm.response.json()?.data?.holdId;",
                  "if (id) setVar('checkoutHoldId', id);"
                ],
                "type": "text/javascript"
              }
            }
          ]
        },
        {
          "name": "04 Create Order with hold (disabled)",
          "disabled": true,
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"{{skuCode}}\",\n  \"quantity\": 1,\n  \"countryCode\": \"{{countryCode}}\",\n  \"expectedUnitPriceCents\": {{expectedUnitPriceCents}},\n  \"orderReference\": \"{{orderReference}}\",\n  \"checkoutHoldId\": \"{{checkoutHoldId}}\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"{{countryCode}}\",\n    \"consumerIp\": \"8.8.8.8\",\n    \"currencyCode\": \"USD\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 5999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 0,\n    \"salesTaxRatePercent\": 0,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"pi_profile_b_example\",\n    \"checkoutSessionId\": \"cs_profile_b_example\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ]
            },
            "description": "Enable only on sandbox, after charging the buyer. Consumes the hold."
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "exec": [
                  "if (pm.response.code === 0) { return; }",
                  "pm.test('2xx', () => pm.expect(pm.response.code).to.be.within(200, 299));"
                ],
                "type": "text/javascript"
              }
            }
          ]
        }
      ]
    },
    {
      "name": "API contract",
      "description": "OpenAPI JSON + Scalar HTML served from the same host as `baseUrl`. Import the JSON into Bruno/Insomnia/Stoplight; open Scalar in a browser.",
      "item": [
        {
          "name": "GET — OpenAPI JSON",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/openapi",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "openapi"
              ]
            },
            "description": "Canonical OpenAPI 3 spec. Cached for 5 minutes (`Cache-Control: public, max-age=300`)."
          }
        },
        {
          "name": "GET — Scalar UI (HTML)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "text/html",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/docs",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "docs"
              ]
            },
            "description": "Open this URL in a browser for the interactive Scalar UI. The HTML response still carries `X-Api-Version` and `X-Request-Id` headers."
          }
        }
      ]
    },
    {
      "name": "Meta",
      "description": "Identity and egress helpers: `GET /whoami` (default fast path; `?diagnostics=1` for full readiness walks) and `GET /whoami-ip`.",
      "item": [
        {
          "name": "GET — Echo the request's normalized client IP",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/whoami-ip",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "whoami-ip"
              ]
            },
            "description": "**Echo the request's normalized client IP**\n\n**Public, unauthenticated; limited to 60 requests a minute per client IP (429 with Retry-After beyond that).** Returns the client IP that Avrix would evaluate for the IP allowlist if this request were authenticated. Use it to:\n\n- Confirm your server's egress IP from `curl` before adding it to a key's `allowed_ips`.\n- Power the dashboard's *Detect my IP* button during key onboarding.\n\nIP precedence: `x-vercel-forwarded-for` → `x-real-ip` → leftmost `x-forwarded-for`. The endpoint never echoes any other request signal. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` for that per-IP budget. The route reads no API key, so it never answers 401 or 403.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/whoami-ip`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 Client IP resolved (or `null` when no header parsed)",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/whoami-ip",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "whoami-ip"
                  ]
                },
                "description": "**Echo the request's normalized client IP**\n\n**Public, unauthenticated; limited to 60 requests a minute per client IP (429 with Retry-After beyond that).** Returns the client IP that Avrix would evaluate for the IP allowlist if this request were authenticated. Use it to:\n\n- Confirm your server's egress IP from `curl` before adding it to a key's `allowed_ips`.\n- Power the dashboard's *Detect my IP* button during key onboarding.\n\nIP precedence: `x-vercel-forwarded-for` → `x-real-ip` → leftmost `x-forwarded-for`. The endpoint never echoes any other request signal. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` for that per-IP budget. The route reads no API key, so it never answers 401 or 403.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/whoami-ip`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"clientIp\": \"203.0.113.5\"\n  },\n  \"meta\": {\n    \"requestId\": \"req_01J9...\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/whoami-ip",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "whoami-ip"
                  ]
                },
                "description": "**Echo the request's normalized client IP**\n\n**Public, unauthenticated; limited to 60 requests a minute per client IP (429 with Retry-After beyond that).** Returns the client IP that Avrix would evaluate for the IP allowlist if this request were authenticated. Use it to:\n\n- Confirm your server's egress IP from `curl` before adding it to a key's `allowed_ips`.\n- Power the dashboard's *Detect my IP* button during key onboarding.\n\nIP precedence: `x-vercel-forwarded-for` → `x-real-ip` → leftmost `x-forwarded-for`. The endpoint never echoes any other request signal. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` for that per-IP budget. The route reads no API key, so it never answers 401 or 403.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/whoami-ip`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Who am I",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/whoami?diagnostics=1",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "whoami"
              ],
              "query": [
                {
                  "key": "diagnostics",
                  "value": "1",
                  "description": "When `1` or `true`, run full integrator diagnostics (publisher warnings, commercial catalog-price warnings, and territory-pricing readiness). Omit for the default fast path. enum: 1, true, yes",
                  "disabled": true
                }
              ]
            },
            "description": "**Who am I**\n\nIdentity echo for the calling API key: company, key metadata (scopes, environment), sandbox flag, and normalized allowlist IPs (masked consistently with keys list). Requires **any** seller scope on the key.\n\n**IP privacy:** Response fields describe **your integration egress**, not buyers.\n\n**Contract posture:** Response includes `data.hasActiveBma` and `data.warnings` (e.g. `NO_ACTIVE_BMA`, `API_SKU_MISSING_CATALOG_PRICE`, `PRICE_COMMITMENT_NOT_CONFIGURED`). Header `X-Avrix-Warning: no_active_bma` when no BMA is signed.\n\n**Capabilities:** `data.capabilities` reports deployment features (`preorderEnabled` (pre-order purchase flows for this company; default true), `backorderEnabled` (durable customer-order backorders; default true — `backorderOnUnavailable` is rejected only while this is false), `activationPolicy` (`warn` | `enforce_known` | `enforce_strict`), `priceCommitmentConfigured`, `checkoutHoldEnabled`, `checkoutHoldConfigured`, `hotDropRedisConfigured`, `idempotencyBackend`, `territoryEnforcementEnabled`, `consumerGeoEnforcementEnabled`, `catalogPriceStrictMode`) — see `https://docs.avrix.io/seller-api/store-profiles` and `https://docs.avrix.io/seller-api/territory`.\n\n**Capability details:** `data.capabilityDetails` splits keyless, preorder, activationEnforcement and priceCommitment into `available` (shipped), `enabled` (feature flag or per-company gate) and `verifiedAt` (first live proof, null until the capability has worked in a real request) — use it to distinguish shipped vs flagged vs proven; the flat booleans stay for compatibility.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/whoami`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Identity payload",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/whoami?diagnostics=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "whoami"
                  ],
                  "query": [
                    {
                      "key": "diagnostics",
                      "value": "1",
                      "description": "When `1` or `true`, run full integrator diagnostics (publisher warnings, commercial catalog-price warnings, and territory-pricing readiness). Omit for the default fast path. enum: 1, true, yes",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Who am I**\n\nIdentity echo for the calling API key: company, key metadata (scopes, environment), sandbox flag, and normalized allowlist IPs (masked consistently with keys list). Requires **any** seller scope on the key.\n\n**IP privacy:** Response fields describe **your integration egress**, not buyers.\n\n**Contract posture:** Response includes `data.hasActiveBma` and `data.warnings` (e.g. `NO_ACTIVE_BMA`, `API_SKU_MISSING_CATALOG_PRICE`, `PRICE_COMMITMENT_NOT_CONFIGURED`). Header `X-Avrix-Warning: no_active_bma` when no BMA is signed.\n\n**Capabilities:** `data.capabilities` reports deployment features (`preorderEnabled` (pre-order purchase flows for this company; default true), `backorderEnabled` (durable customer-order backorders; default true — `backorderOnUnavailable` is rejected only while this is false), `activationPolicy` (`warn` | `enforce_known` | `enforce_strict`), `priceCommitmentConfigured`, `checkoutHoldEnabled`, `checkoutHoldConfigured`, `hotDropRedisConfigured`, `idempotencyBackend`, `territoryEnforcementEnabled`, `consumerGeoEnforcementEnabled`, `catalogPriceStrictMode`) — see `https://docs.avrix.io/seller-api/store-profiles` and `https://docs.avrix.io/seller-api/territory`.\n\n**Capability details:** `data.capabilityDetails` splits keyless, preorder, activationEnforcement and priceCommitment into `available` (shipped), `enabled` (feature flag or per-company gate) and `verifiedAt` (first live proof, null until the capability has worked in a real request) — use it to distinguish shipped vs flagged vs proven; the flat booleans stay for compatibility.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/whoami`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"persona\": \"seller\",\n    \"sandbox\": true,\n    \"requestEnvironment\": \"sandbox\",\n    \"hasActiveBma\": true,\n    \"settlement\": {\n      \"mode\": \"automated_invoice\",\n      \"invoiceWithinDays\": null\n    },\n    \"warnings\": [],\n    \"capabilities\": {\n      \"checkoutHoldEnabled\": true,\n      \"checkoutHoldConfigured\": true,\n      \"hotDropRedisConfigured\": true,\n      \"idempotencyBackend\": \"redis\",\n      \"territoryEnforcementEnabled\": true,\n      \"consumerGeoEnforcementEnabled\": false,\n      \"catalogPriceStrictMode\": true,\n      \"keylessEnabled\": false,\n      \"backorderEnabled\": true,\n      \"activationPolicy\": \"enforce_known\",\n      \"activationEnforceOptIn\": false,\n      \"priceCommitmentConfigured\": true,\n      \"consumerGeoAttestEnabled\": true,\n      \"consumerGeoAttestRequired\": false\n    },\n    \"capabilityDetails\": {\n      \"keyless\": {\n        \"available\": true,\n        \"enabled\": false,\n        \"certified\": false,\n        \"verifiedAt\": null\n      },\n      \"preorder\": {\n        \"available\": true,\n        \"enabled\": false,\n        \"certified\": false,\n        \"verifiedAt\": null\n      },\n      \"activationEnforcement\": {\n        \"available\": true,\n        \"enabled\": false,\n        \"verifiedAt\": null\n      },\n      \"priceCommitment\": {\n        \"available\": true,\n        \"enabled\": true,\n        \"verifiedAt\": \"2026-08-14T09:12:00Z\"\n      }\n    },\n    \"company\": {\n      \"id\": \"00000000-0000-4000-8000-000000000010\",\n      \"name\": \"Sandbox Seller\"\n    },\n    \"key\": {\n      \"id\": \"00000000-0000-4000-8000-000000000011\",\n      \"name\": \"sandbox-checkout\",\n      \"environment\": \"sandbox\",\n      \"scopes\": [\n        \"seller:products:read\",\n        \"seller:keys:pull\",\n        \"seller:orders:preview\"\n      ]\n    },\n    \"integrationReadiness\": {\n      \"sellableSkuCount\": 1,\n      \"sharedSkuCount\": 1,\n      \"allocatedSkuCount\": 1,\n      \"allocatedWithoutShareCount\": 0,\n      \"sharedWithoutAllocationCount\": 0,\n      \"missingTerritoryPricingCount\": 0\n    },\n    \"productionAccess\": {\n      \"status\": \"not_requested\",\n      \"enforced\": true,\n      \"requestedAt\": null,\n      \"approvedAt\": null,\n      \"steps\": [\n        {\n          \"step\": \"api_model_activated\",\n          \"done\": true\n        },\n        {\n          \"step\": \"production_key_created\",\n          \"done\": false\n        },\n        {\n          \"step\": \"production_access_approved\",\n          \"done\": false\n        }\n      ]\n    }\n  },\n  \"meta\": {\n    \"requestId\": \"req_01EXAMPLE\",\n    \"diagnostics\": false\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/whoami?diagnostics=1",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "whoami"
                  ],
                  "query": [
                    {
                      "key": "diagnostics",
                      "value": "1",
                      "description": "When `1` or `true`, run full integrator diagnostics (publisher warnings, commercial catalog-price warnings, and territory-pricing readiness). Omit for the default fast path. enum: 1, true, yes",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Who am I**\n\nIdentity echo for the calling API key: company, key metadata (scopes, environment), sandbox flag, and normalized allowlist IPs (masked consistently with keys list). Requires **any** seller scope on the key.\n\n**IP privacy:** Response fields describe **your integration egress**, not buyers.\n\n**Contract posture:** Response includes `data.hasActiveBma` and `data.warnings` (e.g. `NO_ACTIVE_BMA`, `API_SKU_MISSING_CATALOG_PRICE`, `PRICE_COMMITMENT_NOT_CONFIGURED`). Header `X-Avrix-Warning: no_active_bma` when no BMA is signed.\n\n**Capabilities:** `data.capabilities` reports deployment features (`preorderEnabled` (pre-order purchase flows for this company; default true), `backorderEnabled` (durable customer-order backorders; default true — `backorderOnUnavailable` is rejected only while this is false), `activationPolicy` (`warn` | `enforce_known` | `enforce_strict`), `priceCommitmentConfigured`, `checkoutHoldEnabled`, `checkoutHoldConfigured`, `hotDropRedisConfigured`, `idempotencyBackend`, `territoryEnforcementEnabled`, `consumerGeoEnforcementEnabled`, `catalogPriceStrictMode`) — see `https://docs.avrix.io/seller-api/store-profiles` and `https://docs.avrix.io/seller-api/territory`.\n\n**Capability details:** `data.capabilityDetails` splits keyless, preorder, activationEnforcement and priceCommitment into `available` (shipped), `enabled` (feature flag or per-company gate) and `verifiedAt` (first live proof, null until the capability has worked in a real request) — use it to distinguish shipped vs flagged vs proven; the flat booleans stay for compatibility.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/whoami`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Account",
      "description": "Store-level settings: your selling footprint (the countries and currencies you sell in) and your integration presets (order declaration defaults). Any seller scope can read them; `seller:account:manage` to change them.",
      "item": [
        {
          "name": "GET — Read your selling footprint",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "me",
                "footprint"
              ]
            },
            "description": "**Read your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nAny Seller API key can read the footprint; changing it (`PUT /me/footprint`) requires `seller:account:manage`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Your declared footprint.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "footprint"
                  ]
                },
                "description": "**Read your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nAny Seller API key can read the footprint; changing it (`PUT /me/footprint`) requires `seller:account:manage`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"countries\": [\n      \"NL\"\n    ],\n    \"currencies\": [\n      \"EUR\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "footprint"
                  ]
                },
                "description": "**Read your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nAny Seller API key can read the footprint; changing it (`PUT /me/footprint`) requires `seller:account:manage`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "PUT — Replace your selling footprint",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "me",
                "footprint"
              ]
            },
            "description": "**Replace your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nA replace, not a merge: send the complete set of countries and currencies. An omitted key would leave you unable to express \"I no longer sell here\", and makes a retry mean something different from the first call. Requires `seller:account:manage`, which legacy keys do not hold.\n\n**The answer:** on contract date `2026-12-01` and later, the footprint as stored: each code once, uppercase, sorted, the same body `GET /me/footprint` returns; and a code that names no country (`ZZ`) or no current ISO 4217 currency (`XXQ`) is refused with `422 VALIDATION_FAILED`, `details.issues[].field` naming its position (`countries.1`). Earlier dates echo the request uppercased, duplicates included, and store any code of the right length.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same footprint. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"countries\": [\n    \"NL\"\n  ],\n  \"currencies\": [\n    \"EUR\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 The footprint as stored.",
              "originalRequest": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "footprint"
                  ]
                },
                "description": "**Replace your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nA replace, not a merge: send the complete set of countries and currencies. An omitted key would leave you unable to express \"I no longer sell here\", and makes a retry mean something different from the first call. Requires `seller:account:manage`, which legacy keys do not hold.\n\n**The answer:** on contract date `2026-12-01` and later, the footprint as stored: each code once, uppercase, sorted, the same body `GET /me/footprint` returns; and a code that names no country (`ZZ`) or no current ISO 4217 currency (`XXQ`) is refused with `422 VALIDATION_FAILED`, `details.issues[].field` naming its position (`countries.1`). Earlier dates echo the request uppercased, duplicates included, and store any code of the right length.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same footprint. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"countries\": [\n    \"NL\"\n  ],\n  \"currencies\": [\n    \"EUR\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"countries\": [\n      \"NL\"\n    ],\n    \"currencies\": [\n      \"EUR\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/footprint",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "footprint"
                  ]
                },
                "description": "**Replace your selling footprint**\n\nYour selling footprint: the countries and currencies you sell in. The same record the Commercial configuration screen edits and the order path checks, so an order into a country not listed here is refused with FOOTPRINT_COUNTRY_NOT_DECLARED, and one in a currency not listed with FOOTPRINT_CURRENCY_NOT_DECLARED.\n\nA footprint narrows and never grants. Declaring a country does not obtain the right to sell there: your agreement does that, and this states which part of the granted territory you actually operate in.\n\nA replace, not a merge: send the complete set of countries and currencies. An omitted key would leave you unable to express \"I no longer sell here\", and makes a retry mean something different from the first call. Requires `seller:account:manage`, which legacy keys do not hold.\n\n**The answer:** on contract date `2026-12-01` and later, the footprint as stored: each code once, uppercase, sorted, the same body `GET /me/footprint` returns; and a code that names no country (`ZZ`) or no current ISO 4217 currency (`XXQ`) is refused with `422 VALIDATION_FAILED`, `details.issues[].field` naming its position (`countries.1`). Earlier dates echo the request uppercased, duplicates included, and store any code of the right length.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same footprint. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/footprint`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"countries\": [\n    \"NL\"\n  ],\n  \"currencies\": [\n    \"EUR\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Read your integration presets",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "me",
                "integration-presets"
              ]
            },
            "description": "**Read your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Any Seller API key can read them; changing them requires seller:account:manage.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Your presets (configured false when none are set).",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Read your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Any Seller API key can read them; changing them requires seller:account:manage.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"configured\": true,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"priceIncludesTax\": true,\n    \"storeCountryCode\": \"NL\",\n    \"deriveAmounts\": true,\n    \"updatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Read your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Any Seller API key can read them; changing them requires seller:account:manage.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "PUT — Replace your integration presets",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "me",
                "integration-presets"
              ]
            },
            "description": "**Replace your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Requires seller:account:manage. A replace: send every field (null = no preset for it).\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"salesChannel\": \"web\",\n  \"paymentMethodFamily\": \"card\",\n  \"priceIncludesTax\": true,\n  \"storeCountryCode\": \"NL\",\n  \"deriveAmounts\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 The saved presets.",
              "originalRequest": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Replace your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Requires seller:account:manage. A replace: send every field (null = no preset for it).\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"salesChannel\": \"web\",\n  \"paymentMethodFamily\": \"card\",\n  \"priceIncludesTax\": true,\n  \"storeCountryCode\": \"NL\",\n  \"deriveAmounts\": false\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"configured\": true,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"priceIncludesTax\": true,\n    \"storeCountryCode\": \"NL\",\n    \"deriveAmounts\": true,\n    \"updatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Replace your integration presets**\n\nStore-level defaults for integrationOrderContext With presets set, a production POST /orders (or bulk line) needs only skuId or skuCode, quantity, orderReference, integrationOrderContext.consumerIp and priceCommitmentToken. The server fills salesChannel, paymentMethodFamily and priceIncludesTax from the presets, uses orderReference as checkoutSessionId, takes the sale country from the buyer IP (else the price commitment, else storeCountryCode), and derives currency, gross, net, tax amount and tax rate. Explicit fields always win. Each filled field is recorded as preset or derived (declarationProvenance) on the delivery and sale records, and paymentProcessorReference becomes recommended rather than required. whoami.requiredDeclarationsByOperation lists only what is still needed. Presets belong to the store that owns the API key. Requires seller:account:manage. A replace: send every field (null = no preset for it).\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `PUT /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"salesChannel\": \"web\",\n  \"paymentMethodFamily\": \"card\",\n  \"priceIncludesTax\": true,\n  \"storeCountryCode\": \"NL\",\n  \"deriveAmounts\": false\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "DELETE — Remove your integration presets",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "me",
                "integration-presets"
              ]
            },
            "description": "**Remove your integration presets**\n\nRemoves the presets: orders need the full declaration again.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Presets removed (configured false).",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Remove your integration presets**\n\nRemoves the presets: orders need the full declaration again.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"configured\": true,\n    \"salesChannel\": \"web\",\n    \"paymentMethodFamily\": \"card\",\n    \"priceIncludesTax\": true,\n    \"storeCountryCode\": \"NL\",\n    \"deriveAmounts\": true,\n    \"updatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/me/integration-presets",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "me",
                    "integration-presets"
                  ]
                },
                "description": "**Remove your integration presets**\n\nRemoves the presets: orders need the full declaration again.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/me/integration-presets`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Products",
      "description": "Catalog reads: products list, product detail (editions → releases → SKUs → pricing), and country-scoped pricing. Scope: `seller:products:read`.",
      "item": [
        {
          "name": "GET — List products",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "en-US,en;q=0.9",
                "type": "text",
                "description": "Preferred languages for store copy (q-values supported); used when `locale` is omitted",
                "disabled": true
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              },
              {
                "key": "If-None-Match",
                "value": "",
                "type": "text",
                "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products?limit=50&cursor=&q=&partner=&status=draft&slug=&publisherCompanyId=&locale=&updatedSince=&platform=&externalReference=&externalReferenceSource=&releaseDateFrom=&releaseDateTo=&launchPhase=&tradingState=&productType=&sort=-createdAt&expand=&filters=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search by product name or slug",
                  "disabled": true
                },
                {
                  "key": "partner",
                  "value": "",
                  "description": "Filter by publisher company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars (alias: publisherCompanyId)",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "draft",
                  "description": "Deprecated: filter by the legacy lifecycle rollup (matched against the derived value). Visible products always carry status=active; prefer the launchPhase / tradingState / isArchived response fields. enum: draft, active, discontinued, archived",
                  "disabled": true
                },
                {
                  "key": "slug",
                  "value": "",
                  "description": "Exact catalog product slug (per vendor); narrows list to a single product when shared",
                  "disabled": true
                },
                {
                  "key": "publisherCompanyId",
                  "value": "",
                  "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                  "disabled": true
                },
                {
                  "key": "locale",
                  "value": "",
                  "description": "BCP 47 language tag for vendor `shortDescription` (overrides Accept-Language)",
                  "disabled": true
                },
                {
                  "key": "updatedSince",
                  "value": "",
                  "description": "ISO 8601 — only products whose row was updated on or after this instant (metadata / lifecycle). Price changes never move a product's `updatedAt`: use `GET /catalog/changes` and `sku.pricing_updated` for those. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "platform",
                  "value": "",
                  "description": "Comma-separated platform codes as `GET /platforms` returns them (case-insensitive, at most 20): only products with a shared release on one of these platforms. Additive.",
                  "disabled": true
                },
                {
                  "key": "externalReference",
                  "value": "",
                  "description": "A value from `skus[].externalReferences` on product detail: a Steam app id, a Steam package id (`sub/123` or its digits) or a platform product id. Only products with a shared SKU that carries it. To map many ids at once, use `GET /products/lookup`. Additive.",
                  "disabled": true
                },
                {
                  "key": "externalReferenceSource",
                  "value": "",
                  "description": "Narrows `externalReference` to one source: `steam` (app and package ids) or a platform code in lower case. Needs `externalReference`. Additive.",
                  "disabled": true
                },
                {
                  "key": "releaseDateFrom",
                  "value": "",
                  "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or after this day. Additive.",
                  "disabled": true
                },
                {
                  "key": "releaseDateTo",
                  "value": "",
                  "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or before this day. Additive.",
                  "disabled": true
                },
                {
                  "key": "launchPhase",
                  "value": "",
                  "description": "Comma-separated: `announced`, `pre_order`, `available`. Matches the product's `launchPhase`. Additive.",
                  "disabled": true
                },
                {
                  "key": "tradingState",
                  "value": "",
                  "description": "Comma-separated: `open`, `paused`, `discontinued`. Matches the product's `tradingState`. Additive.",
                  "disabled": true
                },
                {
                  "key": "productType",
                  "value": "",
                  "description": "Comma-separated product types (for example `game`, `dlc`). Additive.",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "-createdAt",
                  "description": "Order of the list. `-createdAt` (the default) is the order the list always had. `name` sorts case-insensitively. A `cursor` belongs to the sort it was issued with: sending it with another sort answers `422 VALIDATION_FAILED` on `cursor`. Additive. enum: -createdAt, createdAt, -updatedAt, updatedAt, name, -name",
                  "disabled": true
                },
                {
                  "key": "expand",
                  "value": "",
                  "description": "Comma-separated list of optional list-level expansions: `availability` adds a per-row `availability` summary (`available`, `allocationRemaining`, `inventoryAvailable`, `skuCount`); `pricing` adds a per-row `pricing` summary (`wholesaleFromCents` from your seller allocation + `listPriceFromCents` from the publisher list price band). **Use this to bundle browse data and avoid the N+1 pattern of one list call followed by 100 detail/availability/pricing calls.** The `availability` field is advisory — call `/availability` for commit-time accuracy. Cacheable by your own HTTP cache per `Authorization`+`Accept-Language`+`expand` (no shared CDN cache).",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                  "disabled": true
                }
              ]
            },
            "description": "**List products**\n\nProducts available from connected partners. Paginated. Filter by q (search name/slug), partner (publisher company ID), or status.\n\n**Pagination:** Stable keyset order by creation time then id (newest first). The `cursor` is a versioned token (v2 encodes created time + id); legacy id-only cursors are still accepted. See `https://docs.avrix.io/seller-api/catalog-and-allocations`.\n\n**Incremental sync:** Optional `updatedSince` (ISO 8601) returns rows whose latest update (or creation) time is on or after that instant — metadata and lifecycle changes. **Price changes do not move `updatedAt` and never appear here:** poll `GET /catalog/changes` (`changedFields` contains `pricing`) and subscribe to `sku.pricing_updated` for those. Combine with **`product.updated`** webhooks and a stored watermark for efficient deltas.\n\n**Store copy language:** `shortDescription` follows the `locale` query parameter if set (`xx` or `xx-YY`), else `Accept-Language`, else English. `meta.localePreference` echoes the resolved preference chain.\n\nEach item includes **store-facing catalog fields** (cover, short description, platforms/regions, **list price in your pricing country** where resolvable) so you can build browse pages and compare **SRP / MSRP** (`listPriceFromCents`) with your **wholesale contract pricing** on `GET /api/seller/v1/allocations` (`pricePerKeyCents`, `businessModel`) — which exists for `wholesale` / `pre_order` grants; under `api` it is `null` and the cost is a share of the territory list price.\n\n**Filters and sort.** `platform`, `externalReference` (with `externalReferenceSource`), `releaseDateFrom`, `releaseDateTo`, `launchPhase`, `tradingState`, `productType` and `sort` are accepted on every contract date. Filters on releases match through the SKUs shared with you. `meta.total` counts the filtered list. Without them the list is served exactly as before.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Products list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages for store copy (q-values supported); used when `locale` is omitted",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products?limit=50&cursor=&q=&partner=&status=draft&slug=&publisherCompanyId=&locale=&updatedSince=&platform=&externalReference=&externalReferenceSource=&releaseDateFrom=&releaseDateTo=&launchPhase=&tradingState=&productType=&sort=-createdAt&expand=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search by product name or slug",
                      "disabled": true
                    },
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Filter by publisher company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars (alias: publisherCompanyId)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "draft",
                      "description": "Deprecated: filter by the legacy lifecycle rollup (matched against the derived value). Visible products always carry status=active; prefer the launchPhase / tradingState / isArchived response fields. enum: draft, active, discontinued, archived",
                      "disabled": true
                    },
                    {
                      "key": "slug",
                      "value": "",
                      "description": "Exact catalog product slug (per vendor); narrows list to a single product when shared",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                      "disabled": true
                    },
                    {
                      "key": "locale",
                      "value": "",
                      "description": "BCP 47 language tag for vendor `shortDescription` (overrides Accept-Language)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "ISO 8601 — only products whose row was updated on or after this instant (metadata / lifecycle). Price changes never move a product's `updatedAt`: use `GET /catalog/changes` and `sku.pricing_updated` for those. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "platform",
                      "value": "",
                      "description": "Comma-separated platform codes as `GET /platforms` returns them (case-insensitive, at most 20): only products with a shared release on one of these platforms. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "externalReference",
                      "value": "",
                      "description": "A value from `skus[].externalReferences` on product detail: a Steam app id, a Steam package id (`sub/123` or its digits) or a platform product id. Only products with a shared SKU that carries it. To map many ids at once, use `GET /products/lookup`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "externalReferenceSource",
                      "value": "",
                      "description": "Narrows `externalReference` to one source: `steam` (app and package ids) or a platform code in lower case. Needs `externalReference`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "releaseDateFrom",
                      "value": "",
                      "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or after this day. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "releaseDateTo",
                      "value": "",
                      "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or before this day. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "launchPhase",
                      "value": "",
                      "description": "Comma-separated: `announced`, `pre_order`, `available`. Matches the product's `launchPhase`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "tradingState",
                      "value": "",
                      "description": "Comma-separated: `open`, `paused`, `discontinued`. Matches the product's `tradingState`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "productType",
                      "value": "",
                      "description": "Comma-separated product types (for example `game`, `dlc`). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-createdAt",
                      "description": "Order of the list. `-createdAt` (the default) is the order the list always had. `name` sorts case-insensitively. A `cursor` belongs to the sort it was issued with: sending it with another sort answers `422 VALIDATION_FAILED` on `cursor`. Additive. enum: -createdAt, createdAt, -updatedAt, updatedAt, name, -name",
                      "disabled": true
                    },
                    {
                      "key": "expand",
                      "value": "",
                      "description": "Comma-separated list of optional list-level expansions: `availability` adds a per-row `availability` summary (`available`, `allocationRemaining`, `inventoryAvailable`, `skuCount`); `pricing` adds a per-row `pricing` summary (`wholesaleFromCents` from your seller allocation + `listPriceFromCents` from the publisher list price band). **Use this to bundle browse data and avoid the N+1 pattern of one list call followed by 100 detail/availability/pricing calls.** The `availability` field is advisory — call `/availability` for commit-time accuracy. Cacheable by your own HTTP cache per `Authorization`+`Accept-Language`+`expand` (no shared CDN cache).",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List products**\n\nProducts available from connected partners. Paginated. Filter by q (search name/slug), partner (publisher company ID), or status.\n\n**Pagination:** Stable keyset order by creation time then id (newest first). The `cursor` is a versioned token (v2 encodes created time + id); legacy id-only cursors are still accepted. See `https://docs.avrix.io/seller-api/catalog-and-allocations`.\n\n**Incremental sync:** Optional `updatedSince` (ISO 8601) returns rows whose latest update (or creation) time is on or after that instant — metadata and lifecycle changes. **Price changes do not move `updatedAt` and never appear here:** poll `GET /catalog/changes` (`changedFields` contains `pricing`) and subscribe to `sku.pricing_updated` for those. Combine with **`product.updated`** webhooks and a stored watermark for efficient deltas.\n\n**Store copy language:** `shortDescription` follows the `locale` query parameter if set (`xx` or `xx-YY`), else `Accept-Language`, else English. `meta.localePreference` echoes the resolved preference chain.\n\nEach item includes **store-facing catalog fields** (cover, short description, platforms/regions, **list price in your pricing country** where resolvable) so you can build browse pages and compare **SRP / MSRP** (`listPriceFromCents`) with your **wholesale contract pricing** on `GET /api/seller/v1/allocations` (`pricePerKeyCents`, `businessModel`) — which exists for `wholesale` / `pre_order` grants; under `api` it is `null` and the cost is a share of the territory list price.\n\n**Filters and sort.** `platform`, `externalReference` (with `externalReferenceSource`), `releaseDateFrom`, `releaseDateTo`, `launchPhase`, `tradingState`, `productType` and `sort` are accepted on every contract date. Filters on releases match through the SKUs shared with you. `meta.total` counts the filtered list. Without them the list is served exactly as before.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"9d706a25-4131-4ef2-85b1-826fd05daa66\",\n      \"readableId\": \"prd_ykzbfs24\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"name\": \"Example Game\",\n      \"slug\": \"example-game\",\n      \"productType\": \"game\",\n      \"launchPhase\": \"draft\",\n      \"tradingState\": \"open\",\n      \"isArchived\": false,\n      \"publisherCompanyId\": \"acme-games\",\n      \"publisherCompanyName\": \"Acme Games\",\n      \"sharedSkus\": [\n        {\n          \"id\": \"6e2fe4b0-a14d-4dda-8c9e-0bf20bb48a1a\",\n          \"skuCode\": \"EXAMPLE-STEAM-WW\",\n          \"platformName\": \"Steam\",\n          \"platformCode\": \"steam\",\n          \"editionName\": \"Standard Edition\",\n          \"keyTypeName\": \"Steam key\",\n          \"srpPriceCents\": 2450,\n          \"srpCurrencyCode\": \"EUR\",\n          \"srpCurrencyExponent\": 2,\n          \"sellable\": true,\n          \"readinessBlockers\": [\n            \"example_readinessblocker\"\n          ],\n          \"pricePerKeyCents\": 2450,\n          \"currencyCode\": \"null\",\n          \"currencyExponent\": 2,\n          \"territoryPrices\": [\n            {\n              \"countryCode\": \"DE\",\n              \"basePriceCents\": 2450,\n              \"basePriceMinor\": 2450,\n              \"zone\": {\n                \"code\": \"EUR\",\n                \"label\": \"Euro area and rest of Europe (EUR)\"\n              },\n              \"currencyCode\": \"EUR\",\n              \"currencyExponent\": 2,\n              \"sellable\": true,\n              \"blockedReason\": null\n            }\n          ]\n        }\n      ],\n      \"coverUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"shortDescription\": \"Race through open city streets with friends.\",\n      \"editionCount\": 12,\n      \"platformNames\": [\n        \"Steam\"\n      ],\n      \"platforms\": [\n        {\n          \"code\": \"steam\",\n          \"name\": \"Example Game\"\n        }\n      ],\n      \"regionNames\": [\n        \"Europe\"\n      ],\n      \"regions\": [\n        {\n          \"code\": \"EU\",\n          \"name\": \"Example Game\"\n        }\n      ],\n      \"editionNamesShared\": [\n        \"example_editionnamesshared\"\n      ],\n      \"sharedRegionReleaseCount\": 12,\n      \"listPriceFromCents\": 2450,\n      \"listPriceCurrencyCode\": \"EUR\",\n      \"listPriceCurrencyExponent\": 3,\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"publisherCompanyImageUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherWebsite\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherCountry\": \"DE\",\n      \"relatedProducts\": [\n        {\n          \"type\": \"requires\",\n          \"productId\": \"7fb47dcc-5511-4f03-8da8-5a0b80dc37b5\"\n        }\n      ]\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/products?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages for store copy (q-values supported); used when `locale` is omitted",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products?limit=50&cursor=&q=&partner=&status=draft&slug=&publisherCompanyId=&locale=&updatedSince=&platform=&externalReference=&externalReferenceSource=&releaseDateFrom=&releaseDateTo=&launchPhase=&tradingState=&productType=&sort=-createdAt&expand=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "q",
                      "value": "",
                      "description": "Search by product name or slug",
                      "disabled": true
                    },
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Filter by publisher company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars (alias: publisherCompanyId)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "draft",
                      "description": "Deprecated: filter by the legacy lifecycle rollup (matched against the derived value). Visible products always carry status=active; prefer the launchPhase / tradingState / isArchived response fields. enum: draft, active, discontinued, archived",
                      "disabled": true
                    },
                    {
                      "key": "slug",
                      "value": "",
                      "description": "Exact catalog product slug (per vendor); narrows list to a single product when shared",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                      "disabled": true
                    },
                    {
                      "key": "locale",
                      "value": "",
                      "description": "BCP 47 language tag for vendor `shortDescription` (overrides Accept-Language)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "ISO 8601 — only products whose row was updated on or after this instant (metadata / lifecycle). Price changes never move a product's `updatedAt`: use `GET /catalog/changes` and `sku.pricing_updated` for those. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "platform",
                      "value": "",
                      "description": "Comma-separated platform codes as `GET /platforms` returns them (case-insensitive, at most 20): only products with a shared release on one of these platforms. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "externalReference",
                      "value": "",
                      "description": "A value from `skus[].externalReferences` on product detail: a Steam app id, a Steam package id (`sub/123` or its digits) or a platform product id. Only products with a shared SKU that carries it. To map many ids at once, use `GET /products/lookup`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "externalReferenceSource",
                      "value": "",
                      "description": "Narrows `externalReference` to one source: `steam` (app and package ids) or a platform code in lower case. Needs `externalReference`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "releaseDateFrom",
                      "value": "",
                      "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or after this day. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "releaseDateTo",
                      "value": "",
                      "description": "`YYYY-MM-DD`, inclusive: only products with a shared release whose release date is on or before this day. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "launchPhase",
                      "value": "",
                      "description": "Comma-separated: `announced`, `pre_order`, `available`. Matches the product's `launchPhase`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "tradingState",
                      "value": "",
                      "description": "Comma-separated: `open`, `paused`, `discontinued`. Matches the product's `tradingState`. Additive.",
                      "disabled": true
                    },
                    {
                      "key": "productType",
                      "value": "",
                      "description": "Comma-separated product types (for example `game`, `dlc`). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-createdAt",
                      "description": "Order of the list. `-createdAt` (the default) is the order the list always had. `name` sorts case-insensitively. A `cursor` belongs to the sort it was issued with: sending it with another sort answers `422 VALIDATION_FAILED` on `cursor`. Additive. enum: -createdAt, createdAt, -updatedAt, updatedAt, name, -name",
                      "disabled": true
                    },
                    {
                      "key": "expand",
                      "value": "",
                      "description": "Comma-separated list of optional list-level expansions: `availability` adds a per-row `availability` summary (`available`, `allocationRemaining`, `inventoryAvailable`, `skuCount`); `pricing` adds a per-row `pricing` summary (`wholesaleFromCents` from your seller allocation + `listPriceFromCents` from the publisher list price band). **Use this to bundle browse data and avoid the N+1 pattern of one list call followed by 100 detail/availability/pricing calls.** The `availability` field is advisory — call `/availability` for commit-time accuracy. Cacheable by your own HTTP cache per `Authorization`+`Accept-Language`+`expand` (no shared CDN cache).",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List products**\n\nProducts available from connected partners. Paginated. Filter by q (search name/slug), partner (publisher company ID), or status.\n\n**Pagination:** Stable keyset order by creation time then id (newest first). The `cursor` is a versioned token (v2 encodes created time + id); legacy id-only cursors are still accepted. See `https://docs.avrix.io/seller-api/catalog-and-allocations`.\n\n**Incremental sync:** Optional `updatedSince` (ISO 8601) returns rows whose latest update (or creation) time is on or after that instant — metadata and lifecycle changes. **Price changes do not move `updatedAt` and never appear here:** poll `GET /catalog/changes` (`changedFields` contains `pricing`) and subscribe to `sku.pricing_updated` for those. Combine with **`product.updated`** webhooks and a stored watermark for efficient deltas.\n\n**Store copy language:** `shortDescription` follows the `locale` query parameter if set (`xx` or `xx-YY`), else `Accept-Language`, else English. `meta.localePreference` echoes the resolved preference chain.\n\nEach item includes **store-facing catalog fields** (cover, short description, platforms/regions, **list price in your pricing country** where resolvable) so you can build browse pages and compare **SRP / MSRP** (`listPriceFromCents`) with your **wholesale contract pricing** on `GET /api/seller/v1/allocations` (`pricePerKeyCents`, `businessModel`) — which exists for `wholesale` / `pre_order` grants; under `api` it is `null` and the cost is a share of the territory list price.\n\n**Filters and sort.** `platform`, `externalReference` (with `externalReferenceSource`), `releaseDateFrom`, `releaseDateTo`, `launchPhase`, `tradingState`, `productType` and `sort` are accepted on every contract date. Filters on releases match through the SKUs shared with you. `meta.total` counts the filtered list. Without them the list is served exactly as before.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Look up products by external reference",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products/lookup?externalReference=620%2Csub%2F12345&source=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products",
                "lookup"
              ],
              "query": [
                {
                  "key": "externalReference",
                  "value": "620,sub/12345",
                  "description": "Comma-separated values, 1 to 100, each 1 to 128 characters (letters, digits, `_ . : / -`). Duplicates are answered once.",
                  "disabled": false
                },
                {
                  "key": "source",
                  "value": "",
                  "description": "Only references from this source: `steam` (app and package ids) or a platform code in lower case.",
                  "disabled": true
                }
              ]
            },
            "description": "**Look up products by external reference**\n\nMaps up to 100 external ids (Steam app ids, Steam package ids, platform product ids) to the products and SKUs shared with you, in one call. One row per value sent, in the order sent; `matches` is empty for a value no shared SKU carries. Visibility is the catalog's: the same agreement, share and lifecycle rules as `GET /products`. Not paged and not cached. Additive.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/lookup`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 One row per value sent",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/lookup?externalReference=620%2Csub%2F12345&source=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    "lookup"
                  ],
                  "query": [
                    {
                      "key": "externalReference",
                      "value": "620,sub/12345",
                      "description": "Comma-separated values, 1 to 100, each 1 to 128 characters (letters, digits, `_ . : / -`). Duplicates are answered once.",
                      "disabled": false
                    },
                    {
                      "key": "source",
                      "value": "",
                      "description": "Only references from this source: `steam` (app and package ids) or a platform code in lower case.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Look up products by external reference**\n\nMaps up to 100 external ids (Steam app ids, Steam package ids, platform product ids) to the products and SKUs shared with you, in one call. One row per value sent, in the order sent; `matches` is empty for a value no shared SKU carries. Visibility is the catalog's: the same agreement, share and lifecycle rules as `GET /products`. Not paged and not cached. Additive.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/lookup`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"externalReference\": \"620\",\n      \"matches\": [\n        {\n          \"productId\": \"8b0f7c55-2f4e-4a8b-9f0e-6b1d2c3a4e5f\",\n          \"readableId\": \"prd_k7m2p9qx\",\n          \"productName\": \"Example Game\",\n          \"productSlug\": \"example-game\",\n          \"publisherCompanyId\": \"acme-games\",\n          \"skuId\": \"3c9a1e2b-7d4f-4c6a-8e2b-1f0d9c8b7a6e\",\n          \"skuCode\": \"EXAMPLE-STEAM-WW\",\n          \"platformCode\": \"steam\",\n          \"reference\": {\n            \"source\": \"steam\",\n            \"name\": \"appId\",\n            \"value\": \"620\"\n          }\n        }\n      ]\n    },\n    {\n      \"externalReference\": \"sub/12345\",\n      \"matches\": []\n    }\n  ],\n  \"meta\": {\n    \"requested\": 2,\n    \"matched\": 1,\n    \"unmatched\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/lookup?externalReference=620%2Csub%2F12345&source=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    "lookup"
                  ],
                  "query": [
                    {
                      "key": "externalReference",
                      "value": "620,sub/12345",
                      "description": "Comma-separated values, 1 to 100, each 1 to 128 characters (letters, digits, `_ . : / -`). Duplicates are answered once.",
                      "disabled": false
                    },
                    {
                      "key": "source",
                      "value": "",
                      "description": "Only references from this source: `steam` (app and package ids) or a platform code in lower case.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Look up products by external reference**\n\nMaps up to 100 external ids (Steam app ids, Steam package ids, platform product ids) to the products and SKUs shared with you, in one call. One row per value sent, in the order sent; `matches` is empty for a value no shared SKU carries. Visibility is the catalog's: the same agreement, share and lifecycle rules as `GET /products`. Not paged and not cached. Additive.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/lookup`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get product detail",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "en-US,en;q=0.9",
                "type": "text",
                "description": "Preferred languages when locale is omitted",
                "disabled": true
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              },
              {
                "key": "If-None-Match",
                "value": "",
                "type": "text",
                "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products/:productId?expand=&locale=&locales=de%2Cfr&descriptionFormat=html&omit=assets%2Ceula%2CreleasePricing",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products",
                ":productId"
              ],
              "query": [
                {
                  "key": "expand",
                  "value": "",
                  "description": "Comma-separated: `default` (editions and pricing, the default), `base` (product base only), `editions`, `pricing`. Any other value is 422.",
                  "disabled": true
                },
                {
                  "key": "locale",
                  "value": "",
                  "description": "BCP 47 language tag for vendor shortDescription",
                  "disabled": true
                },
                {
                  "key": "locales",
                  "value": "de,fr",
                  "description": "Comma-separated language tags (at most 30). Keeps only those languages in `localizedDescriptions` and `eula`; a language keeps its regional variants (`de` keeps `de-AT`). Omitted: every language, as before.",
                  "disabled": true
                },
                {
                  "key": "descriptionFormat",
                  "value": "html",
                  "description": "`text` returns long descriptions as plain text: the store HTML (including embedded players and scripts) reduced to paragraphs, line breaks and bullet points. enum: html, text",
                  "disabled": true
                },
                {
                  "key": "omit",
                  "value": "assets,eula,releasePricing",
                  "description": "Comma-separated blocks to leave out of the body: `assets`, `eula`, `localizedDescriptions`, `systemRequirements`, `relatedProducts`, and `releasePricing` (the deprecated `editions[].releases[].pricing`; the SKU `prices` stay). A named top-level block is absent from the response. An unknown value answers `422 VALIDATION_FAILED`. Omitted: the full body, as before. Additive.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "productId",
                  "value": "{{productId}}",
                  "description": "Catalog product UUID — from GET /products"
                }
              ]
            },
            "description": "**Get product detail**\n\nFull product detail with editions, releases, SKUs, pricing. Use expand=base for minimal (product base only). **Store copy:** `shortDescription` uses `locale` or `Accept-Language` with English fallback (same rules as list products).\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Product detail",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages when locale is omitted",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId?expand=&locale=&locales=de%2Cfr&descriptionFormat=html&omit=assets%2Ceula%2CreleasePricing",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId"
                  ],
                  "query": [
                    {
                      "key": "expand",
                      "value": "",
                      "description": "Comma-separated: `default` (editions and pricing, the default), `base` (product base only), `editions`, `pricing`. Any other value is 422.",
                      "disabled": true
                    },
                    {
                      "key": "locale",
                      "value": "",
                      "description": "BCP 47 language tag for vendor shortDescription",
                      "disabled": true
                    },
                    {
                      "key": "locales",
                      "value": "de,fr",
                      "description": "Comma-separated language tags (at most 30). Keeps only those languages in `localizedDescriptions` and `eula`; a language keeps its regional variants (`de` keeps `de-AT`). Omitted: every language, as before.",
                      "disabled": true
                    },
                    {
                      "key": "descriptionFormat",
                      "value": "html",
                      "description": "`text` returns long descriptions as plain text: the store HTML (including embedded players and scripts) reduced to paragraphs, line breaks and bullet points. enum: html, text",
                      "disabled": true
                    },
                    {
                      "key": "omit",
                      "value": "assets,eula,releasePricing",
                      "description": "Comma-separated blocks to leave out of the body: `assets`, `eula`, `localizedDescriptions`, `systemRequirements`, `relatedProducts`, and `releasePricing` (the deprecated `editions[].releases[].pricing`; the SKU `prices` stay). A named top-level block is absent from the response. An unknown value answers `422 VALIDATION_FAILED`. Omitted: the full body, as before. Additive.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Get product detail**\n\nFull product detail with editions, releases, SKUs, pricing. Use expand=base for minimal (product base only). **Store copy:** `shortDescription` uses `locale` or `Accept-Language` with English fallback (same rules as list products).\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"3c682ed5-f1d5-4bac-8043-6b6fbbd3dfa1\",\n    \"readableId\": \"prd_yq8u6t7a\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"name\": \"Example Game\",\n    \"slug\": \"example-game\",\n    \"productType\": \"game\",\n    \"launchPhase\": \"draft\",\n    \"tradingState\": \"open\",\n    \"isArchived\": false,\n    \"publisherCompanyId\": \"acme-games\",\n    \"publisherCompanyName\": \"Acme Games\",\n    \"publisherCompanyDescription\": \"Example text.\",\n    \"publisherWebsite\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"publisherCountry\": \"DE\",\n    \"publisherCompanyImageUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"shortDescription\": \"Race through open city streets with friends.\",\n    \"coverUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"relatedProducts\": [\n      {\n        \"type\": \"requires\",\n        \"productId\": \"854f2bff-b362-4918-8033-3360a9e1df6b\"\n      }\n    ],\n    \"localizedDescriptions\": [\n      {\n        \"locale\": \"en\",\n        \"short\": \"example_short\",\n        \"long\": \"example_long\",\n        \"promotional\": \"example_promotional\",\n        \"legal\": \"example_legal\"\n      }\n    ],\n    \"supportedLanguages\": [\n      \"example_supportedlanguage\"\n    ],\n    \"ageRatings\": [\n      {\n        \"authority\": \"PEGI\",\n        \"authorityCode\": \"PEGI\",\n        \"code\": \"PEGI_12\",\n        \"label\": \"Main storefront\",\n        \"minAge\": 1\n      }\n    ],\n    \"genres\": [\n      {\n        \"code\": \"ACTION\",\n        \"name\": \"Example Game\"\n      }\n    ],\n    \"tags\": [\n      {\n        \"code\": \"AAA\",\n        \"name\": \"Example Game\"\n      }\n    ],\n    \"features\": [\n      {\n        \"code\": \"ACHIEVEMENTS\",\n        \"name\": \"Example Game\"\n      }\n    ],\n    \"eula\": [\n      {\n        \"locale\": \"en\",\n        \"text\": \"example_text\"\n      }\n    ],\n    \"assets\": {\n      \"screenshots\": [\n        \"https://api.avrix.io/api/seller/v1/example\"\n      ],\n      \"trailers\": [\n        \"https://api.avrix.io/api/seller/v1/example\"\n      ],\n      \"capsules\": [\n        \"https://api.avrix.io/api/seller/v1/example\"\n      ]\n    },\n    \"systemRequirements\": {\n      \"minimum\": \"example_minimum\",\n      \"recommended\": \"example_recommended\"\n    },\n    \"editions\": [\n      {\n        \"id\": \"b8b0ff01-f47a-49dc-8f57-40e88438af85\",\n        \"name\": \"Example Game\",\n        \"slug\": \"example-game\",\n        \"editionType\": \"standard\",\n        \"sortOrder\": 1,\n        \"shortDescription\": \"Race through open city streets with friends.\",\n        \"longDescription\": \"Race through open city streets with friends, tune your car and climb the weekly leaderboards.\",\n        \"keyFeatures\": [\n          \"example_keyfeature\"\n        ],\n        \"editionDifferentiator\": \"example_editiondifferentiator\",\n        \"inheritsProductDescription\": true,\n        \"releases\": [\n          {\n            \"id\": \"83bc7c93-65ba-4b37-82db-6b63ee2fa470\",\n            \"platformCode\": \"steam\",\n            \"platformName\": \"Steam\",\n            \"regionCode\": \"EU\",\n            \"regionName\": \"Europe\",\n            \"launchPhase\": \"draft\",\n            \"tradingState\": \"open\",\n            \"releaseDate\": \"2026-11-02T09:30:00Z\",\n            \"preorderStart\": \"2026-11-02T09:30:00Z\",\n            \"preorderEnd\": \"2026-11-02T09:30:00Z\",\n            \"preorderUnlocked\": true,\n            \"skus\": [\n              {\n                \"id\": \"6dcc563e-8fb8-406f-8ca1-9491f60b582b\",\n                \"skuCode\": \"EXAMPLE-STEAM-WW\",\n                \"keyTypeCode\": \"RETAIL\",\n                \"keyTypeName\": \"Steam key\",\n                \"skuType\": \"regular\",\n                \"bundleItems\": [\n                  {\n                    \"productId\": \"c7bff07d-4a05-43b5-8a57-9a5f25716ecb\",\n                    \"name\": \"Example Game\",\n                    \"slug\": \"example-game\"\n                  }\n                ],\n                \"externalReferences\": [\n                  {\n                    \"owner\": \"VALVE\",\n                    \"source\": \"steam\",\n                    \"name\": \"appId\",\n                    \"value\": \"1172470\"\n                  }\n                ],\n                \"activation\": {\n                  \"type\": \"worldwide\",\n                  \"countries\": [\n                    \"DE\"\n                  ]\n                },\n                \"prices\": [\n                  {\n                    \"sellable\": true,\n                    \"countryCode\": \"DE\",\n                    \"currencyCode\": \"EUR\",\n                    \"basePriceCents\": 2450,\n                    \"currencyExponent\": 2,\n                    \"advertisedPriceCents\": 2450,\n                    \"promoResolution\": \"applied\"\n                  }\n                ],\n                \"promotions\": [\n                  {\n                    \"sourceType\": \"event\",\n                    \"sourceId\": \"014ec920-5907-4d12-8b2d-2938240ba9fe\",\n                    \"name\": \"Example Game\",\n                    \"discountPercent\": 20,\n                    \"priceEffect\": \"list_price\",\n                    \"startDate\": \"2026-11-02T09:30:00Z\",\n                    \"endDate\": \"2026-11-02T09:30:00Z\",\n                    \"window\": \"live\"\n                  }\n                ]\n              }\n            ],\n            \"allowedCountries\": [\n              \"DE\"\n            ]\n          }\n        ]\n      }\n    ],\n    \"refundPolicy\": {\n      \"windowDays\": 1,\n      \"keyRevealForfeitsRefund\": true,\n      \"quarantineOnRefund\": true,\n      \"avrixMovesMoney\": false,\n      \"source\": \"platform\"\n    },\n    \"developer\": \"Acme Studio\",\n    \"creditedPublisher\": \"Acme Games\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages when locale is omitted",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId?expand=&locale=&locales=de%2Cfr&descriptionFormat=html&omit=assets%2Ceula%2CreleasePricing",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId"
                  ],
                  "query": [
                    {
                      "key": "expand",
                      "value": "",
                      "description": "Comma-separated: `default` (editions and pricing, the default), `base` (product base only), `editions`, `pricing`. Any other value is 422.",
                      "disabled": true
                    },
                    {
                      "key": "locale",
                      "value": "",
                      "description": "BCP 47 language tag for vendor shortDescription",
                      "disabled": true
                    },
                    {
                      "key": "locales",
                      "value": "de,fr",
                      "description": "Comma-separated language tags (at most 30). Keeps only those languages in `localizedDescriptions` and `eula`; a language keeps its regional variants (`de` keeps `de-AT`). Omitted: every language, as before.",
                      "disabled": true
                    },
                    {
                      "key": "descriptionFormat",
                      "value": "html",
                      "description": "`text` returns long descriptions as plain text: the store HTML (including embedded players and scripts) reduced to paragraphs, line breaks and bullet points. enum: html, text",
                      "disabled": true
                    },
                    {
                      "key": "omit",
                      "value": "assets,eula,releasePricing",
                      "description": "Comma-separated blocks to leave out of the body: `assets`, `eula`, `localizedDescriptions`, `systemRequirements`, `relatedProducts`, and `releasePricing` (the deprecated `editions[].releases[].pricing`; the SKU `prices` stay). A named top-level block is absent from the response. An unknown value answers `422 VALIDATION_FAILED`. Omitted: the full body, as before. Additive.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Get product detail**\n\nFull product detail with editions, releases, SKUs, pricing. Use expand=base for minimal (product base only). **Store copy:** `shortDescription` uses `locale` or `Accept-Language` with English fallback (same rules as list products).\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"productId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get product pricing",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              },
              {
                "key": "If-None-Match",
                "value": "",
                "type": "text",
                "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products/:productId/pricing?countryCode=&country=&expand=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products",
                ":productId",
                "pricing"
              ],
              "query": [
                {
                  "key": "countryCode",
                  "value": "",
                  "description": "Comma-separated ISO 3166-1 alpha-2 codes (e.g. `US,DE,GB`) — the canonical spelling, the same as the availability routes.",
                  "disabled": true
                },
                {
                  "key": "country",
                  "value": "",
                  "description": "Alias of `countryCode` (the original pricing spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                  "disabled": true
                },
                {
                  "key": "expand",
                  "value": "",
                  "description": "product = include product base in response",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "productId",
                  "value": "{{productId}}",
                  "description": "Catalog product UUID — from GET /products"
                }
              ]
            },
            "description": "**Get product pricing**\n\nPricing per release and country. Use expand=product to include product { id, name, slug } in one request.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/pricing`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Pricing data",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId/pricing?countryCode=&country=&expand=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId",
                    "pricing"
                  ],
                  "query": [
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Comma-separated ISO 3166-1 alpha-2 codes (e.g. `US,DE,GB`) — the canonical spelling, the same as the availability routes.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original pricing spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    },
                    {
                      "key": "expand",
                      "value": "",
                      "description": "product = include product base in response",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Get product pricing**\n\nPricing per release and country. Use expand=product to include product { id, name, slug } in one request.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/pricing`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"releaseId\": \"e6dbe63e-5175-4d04-86e5-a08296ceca3e\",\n      \"editionId\": \"e299f770-36fa-48a6-8228-adeb5adf2ee8\",\n      \"editionName\": \"Standard Edition\",\n      \"editionSlug\": \"example-game\",\n      \"platformCode\": \"steam\",\n      \"platformName\": \"Steam\",\n      \"regionCode\": \"EU\",\n      \"regionName\": \"Europe\",\n      \"releaseDate\": \"2026-11-02T09:30:00Z\",\n      \"preorderStart\": \"2026-11-02T09:30:00Z\",\n      \"preorderEnd\": \"2026-11-02T09:30:00Z\",\n      \"preorderUnlocked\": true,\n      \"skus\": [\n        {\n          \"id\": \"05c0bff8-bf0c-4798-8acf-4680df088607\",\n          \"skuCode\": \"EXAMPLE-STEAM-WW\",\n          \"prices\": [\n            {\n              \"countryCode\": \"DE\",\n              \"currencyCode\": \"EUR\",\n              \"basePriceCents\": 2450,\n              \"currencyExponent\": 2,\n              \"sellable\": true,\n              \"zone\": {\n                \"code\": \"EUR\",\n                \"label\": \"Euro area and rest of Europe (EUR)\"\n              },\n              \"listPromo\": {\n                \"sourceType\": \"event\",\n                \"sourceId\": \"77528dac-20c5-4ae4-8547-872c35c198c4\",\n                \"discountPercent\": 20,\n                \"priceEffect\": \"list_price\",\n                \"startDate\": \"2026-11-02T09:30:00Z\",\n                \"endDate\": \"2026-11-02T09:30:00Z\"\n              },\n              \"advertisedPriceCents\": 2450,\n              \"promo\": {\n                \"sourceType\": \"event\",\n                \"sourceId\": \"e52f8a20-c7d0-4693-81b1-859997e181a6\",\n                \"discountPercent\": 20,\n                \"priceEffect\": \"settlement_price\",\n                \"startDate\": \"2026-11-02T09:30:00Z\",\n                \"endDate\": \"2026-11-02T09:30:00Z\"\n              },\n              \"promoResolution\": \"applied\"\n            }\n          ],\n          \"promotions\": [\n            {\n              \"sourceType\": \"event\",\n              \"sourceId\": \"58cabacc-d870-4343-8368-190361c6ead4\",\n              \"name\": \"Example Game\",\n              \"discountPercent\": 20,\n              \"priceEffect\": \"list_price\",\n              \"startDate\": \"2026-11-02T09:30:00Z\",\n              \"endDate\": \"2026-11-02T09:30:00Z\",\n              \"window\": \"live\"\n            }\n          ]\n        }\n      ],\n      \"launchPhase\": \"available\",\n      \"tradingState\": \"open\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId/pricing?countryCode=&country=&expand=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId",
                    "pricing"
                  ],
                  "query": [
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Comma-separated ISO 3166-1 alpha-2 codes (e.g. `US,DE,GB`) — the canonical spelling, the same as the availability routes.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original pricing spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    },
                    {
                      "key": "expand",
                      "value": "",
                      "description": "product = include product base in response",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Get product pricing**\n\nPricing per release and country. Use expand=product to include product { id, name, slug } in one request.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/pricing`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"productId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Download product media ZIP",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              },
              {
                "key": "If-None-Match",
                "value": "",
                "type": "text",
                "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/products/:productId/media/download",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "products",
                ":productId",
                "media",
                "download"
              ],
              "variable": [
                {
                  "key": "productId",
                  "value": "{{productId}}",
                  "description": "Catalog product UUID — from GET /products"
                }
              ]
            },
            "description": "**Download product media ZIP**\n\nStreams a ZIP archive of screenshots, trailers, and capsule art for a seller-visible product. Requires `seller:products:read`. Console session downloads (cookie + `?company=`) remain supported for the seller UI but are outside this Bearer contract.\n\nThe response carries an `ETag` computed from the archive's asset list; send it back as `If-None-Match` to get `304 Not Modified` without a download. `HEAD` returns the same headers without building the archive.\n\n**Streaming and completeness.** Each file is streamed into the archive from storage, so the first bytes arrive before the last file is read. A file that cannot be fetched is left out and the status is already `200` by then. On contract date `2026-12-01` and later the archive's last entry is `avrix-media-manifest.json`, `{\"complete\": true|false, \"entries\": [{\"filename\", \"included\"}]}`, so a store can tell a complete archive from a partial one; that archive has its own `ETag`. Earlier dates have no manifest entry.\n\n**Errors.** On `2026-12-01` and later, errors use the standard error envelope (`code`, `message`, `hint`, `doc_url`, `requestId`), a product not shared with you answers `404 PRODUCT_NOT_SHARED` (as on product detail), and a request without a key answers the Seller API `401`. Earlier dates keep the short `{code, message, requestId}` body and `NOT_FOUND`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/media/download`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 ZIP archive of product media",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId/media/download",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId",
                    "media",
                    "download"
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Download product media ZIP**\n\nStreams a ZIP archive of screenshots, trailers, and capsule art for a seller-visible product. Requires `seller:products:read`. Console session downloads (cookie + `?company=`) remain supported for the seller UI but are outside this Bearer contract.\n\nThe response carries an `ETag` computed from the archive's asset list; send it back as `If-None-Match` to get `304 Not Modified` without a download. `HEAD` returns the same headers without building the archive.\n\n**Streaming and completeness.** Each file is streamed into the archive from storage, so the first bytes arrive before the last file is read. A file that cannot be fetched is left out and the status is already `200` by then. On contract date `2026-12-01` and later the archive's last entry is `avrix-media-manifest.json`, `{\"complete\": true|false, \"entries\": [{\"filename\", \"included\"}]}`, so a store can tell a complete archive from a partial one; that archive has its own `ETag`. Earlier dates have no manifest entry.\n\n**Errors.** On `2026-12-01` and later, errors use the standard error envelope (`code`, `message`, `hint`, `doc_url`, `requestId`), a product not shared with you answers `404 PRODUCT_NOT_SHARED` (as on product detail), and a request without a key answers the Seller API `401`. Earlier dates keep the short `{code, message, requestId}` body and `NOT_FOUND`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/media/download`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the `ETag` of your stored copy. While nothing has changed the answer is `304 Not Modified` with no body.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/products/:productId/media/download",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "products",
                    ":productId",
                    "media",
                    "download"
                  ],
                  "variable": [
                    {
                      "key": "productId",
                      "value": "{{productId}}",
                      "description": "Catalog product UUID — from GET /products"
                    }
                  ]
                },
                "description": "**Download product media ZIP**\n\nStreams a ZIP archive of screenshots, trailers, and capsule art for a seller-visible product. Requires `seller:products:read`. Console session downloads (cookie + `?company=`) remain supported for the seller UI but are outside this Bearer contract.\n\nThe response carries an `ETag` computed from the archive's asset list; send it back as `If-None-Match` to get `304 Not Modified` without a download. `HEAD` returns the same headers without building the archive.\n\n**Streaming and completeness.** Each file is streamed into the archive from storage, so the first bytes arrive before the last file is read. A file that cannot be fetched is left out and the status is already `200` by then. On contract date `2026-12-01` and later the archive's last entry is `avrix-media-manifest.json`, `{\"complete\": true|false, \"entries\": [{\"filename\", \"included\"}]}`, so a store can tell a complete archive from a partial one; that archive has its own `ETag`. Earlier dates have no manifest entry.\n\n**Errors.** On `2026-12-01` and later, errors use the standard error envelope (`code`, `message`, `hint`, `doc_url`, `requestId`), a product not shared with you answers `404 PRODUCT_NOT_SHARED` (as on product detail), and a request without a key answers the Seller API `401`. Earlier dates keep the short `{code, message, requestId}` body and `NOT_FOUND`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/products/{productId}/media/download`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"productId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Catalog",
      "description": "Bulk catalog sync: checksum and incremental changes for cheap drift detection, full snapshot, and async export jobs. Scope: `seller:products:read`.",
      "item": [
        {
          "name": "GET — Catalog integrity digest",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/catalog/checksum?partner=&publisherCompanyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "catalog",
                "checksum"
              ],
              "query": [
                {
                  "key": "partner",
                  "value": "",
                  "description": "Filter digest to a single publisher company ID (slug-safe identifier)",
                  "disabled": true
                },
                {
                  "key": "publisherCompanyId",
                  "value": "",
                  "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                  "disabled": true
                }
              ]
            },
            "description": "**Catalog integrity digest**\n\nDeterministic lowercase hex SHA-256 fingerprint of visible catalog rows (**product id** + **product `updatedAt`**) sorted canonically (`digestAlgorithm`: `sha256-sorted-product-rows-v1`). Use between full `/catalog/snapshot` pulls to detect drift without downloading the snapshot body. Optional `partner` / `publisherCompanyId` matches `/products` publisher scoping.\n\n`changesCursor` is the seller's current change-feed position: it advances on every recorded change, **including price changes, which the digest never sees** (they do not move a product's `updatedAt`). When it differs from the cursor you last applied, poll `GET /catalog/changes?cursor=`; when `digest` differs from your mirror, cold-start with the snapshot. The cursor is seller-wide even when `partner` scopes the digest.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/checksum`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Integrity digest",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/checksum?partner=&publisherCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "checksum"
                  ],
                  "query": [
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Filter digest to a single publisher company ID (slug-safe identifier)",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Catalog integrity digest**\n\nDeterministic lowercase hex SHA-256 fingerprint of visible catalog rows (**product id** + **product `updatedAt`**) sorted canonically (`digestAlgorithm`: `sha256-sorted-product-rows-v1`). Use between full `/catalog/snapshot` pulls to detect drift without downloading the snapshot body. Optional `partner` / `publisherCompanyId` matches `/products` publisher scoping.\n\n`changesCursor` is the seller's current change-feed position: it advances on every recorded change, **including price changes, which the digest never sees** (they do not move a product's `updatedAt`). When it differs from the cursor you last applied, poll `GET /catalog/changes?cursor=`; when `digest` differs from your mirror, cold-start with the snapshot. The cursor is seller-wide even when `partner` scopes the digest.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/checksum`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"totalProducts\": 2450,\n    \"maxUpdatedAt\": \"2026-11-02T09:30:00Z\",\n    \"digest\": \"sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\",\n    \"digestAlgorithm\": \"sha256-sorted-product-rows-v1\",\n    \"changesCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"generatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/checksum?partner=&publisherCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "checksum"
                  ],
                  "query": [
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Filter digest to a single publisher company ID (slug-safe identifier)",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `partner` (still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming `partner`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Catalog integrity digest**\n\nDeterministic lowercase hex SHA-256 fingerprint of visible catalog rows (**product id** + **product `updatedAt`**) sorted canonically (`digestAlgorithm`: `sha256-sorted-product-rows-v1`). Use between full `/catalog/snapshot` pulls to detect drift without downloading the snapshot body. Optional `partner` / `publisherCompanyId` matches `/products` publisher scoping.\n\n`changesCursor` is the seller's current change-feed position: it advances on every recorded change, **including price changes, which the digest never sees** (they do not move a product's `updatedAt`). When it differs from the cursor you last applied, poll `GET /catalog/changes?cursor=`; when `digest` differs from your mirror, cold-start with the snapshot. The cursor is seller-wide even when `partner` scopes the digest.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/checksum`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Catalog visibility delta",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/catalog/changes?since=&limit=500&cursor=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "catalog",
                "changes"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "",
                  "description": "ISO-8601 cursor — return events after this timestamp (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "500",
                  "description": "Maximum events to return (default 500, max 5000). On contract date `2026-12-01` and later a value that is not a whole number from 1 to 5000 is refused with 422; earlier dates fall back to the default or clamp. (1–5000)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque feed position from `meta.nextCursor`, a snapshot's `meta.changesCursor` or a checksum's `changesCursor` — the preferred paging mode (tie- and clock-skew-safe). Returns events strictly after that position. When both `cursor` and `since` are sent, the cursor wins.",
                  "disabled": true
                }
              ]
            },
            "description": "**Catalog visibility delta**\n\nPer-seller feed of catalog visibility transitions (`added`, `updated`, `removed` tombstones) and facet changes (`changedFields`). This is the delta source for **price changes**: they are recorded here with `changedFields: [\"pricing\"]` and never move a product's `updatedAt`. Use with `/catalog/snapshot` or `/products` for mirror correctness when products leave the catalog.\n\n**Cursor loop:** start from the snapshot's `meta.changesCursor` (or the checksum's `changesCursor`), pass it as `cursor`, apply the page, persist `meta.nextCursor` when present (it is the position of the last row returned; `null` means the page was empty — keep the cursor you sent) and poll again immediately while `meta.hasMore` is true.\n\n**Retention SLA:** delta events are retained for **at least 30 days**. A store offline for up to a month catches up via deltas alone; beyond retention (or on `GET /catalog/checksum` drift), cold-start with `GET /catalog/snapshot`. On contract date `2026-12-01` and later a position beyond retention is answered `409 CATALOG_RESYNC_REQUIRED` instead of a page with a silent gap.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Visibility changes",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/changes?since=&limit=500&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "changes"
                  ],
                  "query": [
                    {
                      "key": "since",
                      "value": "",
                      "description": "ISO-8601 cursor — return events after this timestamp (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Maximum events to return (default 500, max 5000). On contract date `2026-12-01` and later a value that is not a whole number from 1 to 5000 is refused with 422; earlier dates fall back to the default or clamp. (1–5000)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque feed position from `meta.nextCursor`, a snapshot's `meta.changesCursor` or a checksum's `changesCursor` — the preferred paging mode (tie- and clock-skew-safe). Returns events strictly after that position. When both `cursor` and `since` are sent, the cursor wins.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Catalog visibility delta**\n\nPer-seller feed of catalog visibility transitions (`added`, `updated`, `removed` tombstones) and facet changes (`changedFields`). This is the delta source for **price changes**: they are recorded here with `changedFields: [\"pricing\"]` and never move a product's `updatedAt`. Use with `/catalog/snapshot` or `/products` for mirror correctness when products leave the catalog.\n\n**Cursor loop:** start from the snapshot's `meta.changesCursor` (or the checksum's `changesCursor`), pass it as `cursor`, apply the page, persist `meta.nextCursor` when present (it is the position of the last row returned; `null` means the page was empty — keep the cursor you sent) and poll again immediately while `meta.hasMore` is true.\n\n**Retention SLA:** delta events are retained for **at least 30 days**. A store offline for up to a month catches up via deltas alone; beyond retention (or on `GET /catalog/checksum` drift), cold-start with `GET /catalog/snapshot`. On contract date `2026-12-01` and later a position beyond retention is answered `409 CATALOG_RESYNC_REQUIRED` instead of a page with a silent gap.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"changes\": [\n      {\n        \"productId\": \"61f2378b-1450-4939-83e8-a761b166e3b5\",\n        \"skuId\": \"73496151-1dab-4bc5-88fc-cdebaa27b76f\",\n        \"skuCode\": \"null\",\n        \"type\": \"added\",\n        \"occurredAt\": \"2026-11-02T09:30:00Z\",\n        \"changedFields\": [\n          \"pricing\"\n        ]\n      }\n    ]\n  },\n  \"meta\": {\n    \"requestId\": \"ffa5ec15-b04b-47f0-8172-1d777c400b26\",\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true,\n    \"limit\": 50,\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/catalog/changes?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/changes?since=&limit=500&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "changes"
                  ],
                  "query": [
                    {
                      "key": "since",
                      "value": "",
                      "description": "ISO-8601 cursor — return events after this timestamp (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Maximum events to return (default 500, max 5000). On contract date `2026-12-01` and later a value that is not a whole number from 1 to 5000 is refused with 422; earlier dates fall back to the default or clamp. (1–5000)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque feed position from `meta.nextCursor`, a snapshot's `meta.changesCursor` or a checksum's `changesCursor` — the preferred paging mode (tie- and clock-skew-safe). Returns events strictly after that position. When both `cursor` and `since` are sent, the cursor wins.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Catalog visibility delta**\n\nPer-seller feed of catalog visibility transitions (`added`, `updated`, `removed` tombstones) and facet changes (`changedFields`). This is the delta source for **price changes**: they are recorded here with `changedFields: [\"pricing\"]` and never move a product's `updatedAt`. Use with `/catalog/snapshot` or `/products` for mirror correctness when products leave the catalog.\n\n**Cursor loop:** start from the snapshot's `meta.changesCursor` (or the checksum's `changesCursor`), pass it as `cursor`, apply the page, persist `meta.nextCursor` when present (it is the position of the last row returned; `null` means the page was empty — keep the cursor you sent) and poll again immediately while `meta.hasMore` is true.\n\n**Retention SLA:** delta events are retained for **at least 30 days**. A store offline for up to a month catches up via deltas alone; beyond retention (or on `GET /catalog/checksum` drift), cold-start with `GET /catalog/snapshot`. On contract date `2026-12-01` and later a position beyond retention is answered `409 CATALOG_RESYNC_REQUIRED` instead of a page with a silent gap.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Cold-start catalog snapshot",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept-Language",
                "value": "en-US,en;q=0.9",
                "type": "text",
                "description": "Preferred languages for store copy (q-values supported)",
                "disabled": true
              },
              {
                "key": "Accept-Encoding",
                "value": "",
                "type": "text",
                "description": "Set to `gzip` (or include `gzip` in the list) to receive a gzipped body",
                "disabled": true
              },
              {
                "key": "If-None-Match",
                "value": "",
                "type": "text",
                "description": "Conditional GET: send the previous response's `ETag` to receive `304 Not Modified` when the catalog hasn't changed",
                "disabled": true
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/catalog/snapshot?format=json&pricing=territory",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "catalog",
                "snapshot"
              ],
              "query": [
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` (default) returns one document; `ndjson` streams the same snapshot as newline-delimited JSON for very large stores (100k+ SKUs) — line 1 is the meta object (stamped format: \"ndjson\"), each following line is one product row. Identical ETag semantics: send If-None-Match and get 304 when unchanged. enum: json, ndjson",
                  "disabled": true
                },
                {
                  "key": "pricing",
                  "value": "territory",
                  "description": "`territory` adds `territoryPrices` (every country list price) to each shared SKU, so a cold sync needs no `GET /products/{productId}/pricing` call per product. Cached and ETagged separately from the default snapshot. enum: territory",
                  "disabled": true
                }
              ]
            },
            "description": "**Cold-start catalog snapshot**\n\nReturns the seller's **entire** visible catalog (every product across every connected publisher) in a single denormalised JSON payload, plus per-row `availability` and `pricing` expansions. Recommended for seeding a new store instead of crawling 50k rows through `/products`.\n\n**After the snapshot:** persist `meta.changesCursor` and continue with `GET /catalog/changes?cursor=` — it lists every later change with the facets that moved (`changedFields`), **price changes included**. A price change never moves a product's `updatedAt`, so `meta.maxUpdatedAt` + `GET /products?updatedSince=` is a metadata / lifecycle delta only. Subscribe to `sku.pricing_updated`, `product.updated` and `allocation.updated` for push.\n\n**Caching:** Short-lived origin cache per `(sellerCompanyId, locale)`. No shared CDN cache: the response is `private` and key-scoped; your own cache may keep it for 5 minutes. Stable weak ETag derived from `(maxUpdatedAt, totalProducts, changesCursor)` — the feed position makes it move on every recorded change, prices included; a revalidation with `If-None-Match` returns 304 with no JSON serialization.\n\n**Compression:** when `Accept-Encoding: gzip` is set, the response body is gzipped and `Content-Encoding: gzip` is returned.\n\n**Rate-limit:** participates in the cheap `read-cached` bucket; only true origin work debits the regular `read` bucket. A daily snapshot pull costs ~zero rate budget.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 413, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/snapshot`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Full seller catalog snapshot",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages for store copy (q-values supported)",
                    "disabled": true
                  },
                  {
                    "key": "Accept-Encoding",
                    "value": "",
                    "type": "text",
                    "description": "Set to `gzip` (or include `gzip` in the list) to receive a gzipped body",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the previous response's `ETag` to receive `304 Not Modified` when the catalog hasn't changed",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/snapshot?format=json&pricing=territory",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "snapshot"
                  ],
                  "query": [
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) returns one document; `ndjson` streams the same snapshot as newline-delimited JSON for very large stores (100k+ SKUs) — line 1 is the meta object (stamped format: \"ndjson\"), each following line is one product row. Identical ETag semantics: send If-None-Match and get 304 when unchanged. enum: json, ndjson",
                      "disabled": true
                    },
                    {
                      "key": "pricing",
                      "value": "territory",
                      "description": "`territory` adds `territoryPrices` (every country list price) to each shared SKU, so a cold sync needs no `GET /products/{productId}/pricing` call per product. Cached and ETagged separately from the default snapshot. enum: territory",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Cold-start catalog snapshot**\n\nReturns the seller's **entire** visible catalog (every product across every connected publisher) in a single denormalised JSON payload, plus per-row `availability` and `pricing` expansions. Recommended for seeding a new store instead of crawling 50k rows through `/products`.\n\n**After the snapshot:** persist `meta.changesCursor` and continue with `GET /catalog/changes?cursor=` — it lists every later change with the facets that moved (`changedFields`), **price changes included**. A price change never moves a product's `updatedAt`, so `meta.maxUpdatedAt` + `GET /products?updatedSince=` is a metadata / lifecycle delta only. Subscribe to `sku.pricing_updated`, `product.updated` and `allocation.updated` for push.\n\n**Caching:** Short-lived origin cache per `(sellerCompanyId, locale)`. No shared CDN cache: the response is `private` and key-scoped; your own cache may keep it for 5 minutes. Stable weak ETag derived from `(maxUpdatedAt, totalProducts, changesCursor)` — the feed position makes it move on every recorded change, prices included; a revalidation with `If-None-Match` returns 304 with no JSON serialization.\n\n**Compression:** when `Accept-Encoding: gzip` is set, the response body is gzipped and `Content-Encoding: gzip` is returned.\n\n**Rate-limit:** participates in the cheap `read-cached` bucket; only true origin work debits the regular `read` bucket. A daily snapshot pull costs ~zero rate budget.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 413, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/snapshot`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"meta\": {\n    \"totalProducts\": 2450,\n    \"maxUpdatedAt\": \"2026-11-02T09:30:00Z\",\n    \"changesCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"availabilityCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"generatedAt\": \"2026-11-02T09:30:00Z\",\n    \"version\": 1\n  },\n  \"data\": [\n    {\n      \"id\": \"48ebef6a-5355-4743-8574-04e74f438113\",\n      \"readableId\": \"prd_dzzkj22z\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"name\": \"Example Game\",\n      \"slug\": \"example-game\",\n      \"productType\": \"game\",\n      \"launchPhase\": \"draft\",\n      \"tradingState\": \"open\",\n      \"isArchived\": false,\n      \"publisherCompanyId\": \"acme-games\",\n      \"publisherCompanyName\": \"Acme Games\",\n      \"sharedSkus\": [\n        {\n          \"id\": \"e9f21c90-c8aa-417a-85cb-41780a612e26\",\n          \"skuCode\": \"EXAMPLE-STEAM-WW\",\n          \"platformName\": \"Steam\",\n          \"platformCode\": \"steam\",\n          \"editionName\": \"Standard Edition\",\n          \"keyTypeName\": \"Steam key\",\n          \"srpPriceCents\": 2450,\n          \"srpCurrencyCode\": \"EUR\",\n          \"srpCurrencyExponent\": 2,\n          \"sellable\": true,\n          \"readinessBlockers\": [\n            \"example_readinessblocker\"\n          ],\n          \"pricePerKeyCents\": 2450,\n          \"currencyCode\": \"null\",\n          \"currencyExponent\": 2,\n          \"territoryPrices\": [\n            {\n              \"countryCode\": \"DE\",\n              \"basePriceCents\": 2450,\n              \"basePriceMinor\": 2450,\n              \"zone\": {\n                \"code\": \"EUR\",\n                \"label\": \"Euro area and rest of Europe (EUR)\"\n              },\n              \"currencyCode\": \"EUR\",\n              \"currencyExponent\": 2,\n              \"sellable\": true,\n              \"blockedReason\": null\n            }\n          ]\n        }\n      ],\n      \"coverUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"shortDescription\": \"Race through open city streets with friends.\",\n      \"editionCount\": 12,\n      \"platformNames\": [\n        \"Steam\"\n      ],\n      \"platforms\": [\n        {\n          \"code\": \"steam\",\n          \"name\": \"Example Game\"\n        }\n      ],\n      \"regionNames\": [\n        \"Europe\"\n      ],\n      \"regions\": [\n        {\n          \"code\": \"EU\",\n          \"name\": \"Example Game\"\n        }\n      ],\n      \"editionNamesShared\": [\n        \"example_editionnamesshared\"\n      ],\n      \"sharedRegionReleaseCount\": 12,\n      \"listPriceFromCents\": 2450,\n      \"listPriceCurrencyCode\": \"EUR\",\n      \"listPriceCurrencyExponent\": 3,\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"publisherCompanyImageUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherWebsite\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherCountry\": \"DE\",\n      \"relatedProducts\": [\n        {\n          \"type\": \"requires\",\n          \"productId\": \"640b3f65-149d-4062-8c6d-089eed11e11d\"\n        }\n      ]\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept-Language",
                    "value": "en-US,en;q=0.9",
                    "type": "text",
                    "description": "Preferred languages for store copy (q-values supported)",
                    "disabled": true
                  },
                  {
                    "key": "Accept-Encoding",
                    "value": "",
                    "type": "text",
                    "description": "Set to `gzip` (or include `gzip` in the list) to receive a gzipped body",
                    "disabled": true
                  },
                  {
                    "key": "If-None-Match",
                    "value": "",
                    "type": "text",
                    "description": "Conditional GET: send the previous response's `ETag` to receive `304 Not Modified` when the catalog hasn't changed",
                    "disabled": true
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/snapshot?format=json&pricing=territory",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "snapshot"
                  ],
                  "query": [
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) returns one document; `ndjson` streams the same snapshot as newline-delimited JSON for very large stores (100k+ SKUs) — line 1 is the meta object (stamped format: \"ndjson\"), each following line is one product row. Identical ETag semantics: send If-None-Match and get 304 when unchanged. enum: json, ndjson",
                      "disabled": true
                    },
                    {
                      "key": "pricing",
                      "value": "territory",
                      "description": "`territory` adds `territoryPrices` (every country list price) to each shared SKU, so a cold sync needs no `GET /products/{productId}/pricing` call per product. Cached and ETagged separately from the default snapshot. enum: territory",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Cold-start catalog snapshot**\n\nReturns the seller's **entire** visible catalog (every product across every connected publisher) in a single denormalised JSON payload, plus per-row `availability` and `pricing` expansions. Recommended for seeding a new store instead of crawling 50k rows through `/products`.\n\n**After the snapshot:** persist `meta.changesCursor` and continue with `GET /catalog/changes?cursor=` — it lists every later change with the facets that moved (`changedFields`), **price changes included**. A price change never moves a product's `updatedAt`, so `meta.maxUpdatedAt` + `GET /products?updatedSince=` is a metadata / lifecycle delta only. Subscribe to `sku.pricing_updated`, `product.updated` and `allocation.updated` for push.\n\n**Caching:** Short-lived origin cache per `(sellerCompanyId, locale)`. No shared CDN cache: the response is `private` and key-scoped; your own cache may keep it for 5 minutes. Stable weak ETag derived from `(maxUpdatedAt, totalProducts, changesCursor)` — the feed position makes it move on every recorded change, prices included; a revalidation with `If-None-Match` returns 304 with no JSON serialization.\n\n**Compression:** when `Accept-Encoding: gzip` is set, the response body is gzipped and `Content-Encoding: gzip` is returned.\n\n**Rate-limit:** participates in the cheap `read-cached` bucket; only true origin work debits the regular `read` bucket. A daily snapshot pull costs ~zero rate budget.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 304, 400, 401, 403, 413, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/snapshot`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Enqueue a catalog export",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/catalog/exports",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "catalog",
                "exports"
              ]
            },
            "description": "**Enqueue a catalog export**\n\nStarts an async job that builds an immutable gzip NDJSON catalog artifact (same payload as GET /catalog/snapshot?format=ndjson). Poll GET /catalog/exports/{exportId} or subscribe to catalog.export_ready. Synchronous snapshot remains available.\n\nThe optional body `{\"pricing\": \"territory\"}` builds the export with every country price per shared SKU (`sharedSkus[].territoryPrices[]`), the payload of `GET /catalog/snapshot?pricing=territory`. An empty body builds the plain export, as before. On contract date `2026-12-01` and later a body that is not a JSON object, an unknown field or another `pricing` value answers `422 VALIDATION_FAILED`; earlier dates ignore a body they cannot use.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 202, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/catalog/exports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"pricing\": \"territory\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "202 Export accepted",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/exports",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "exports"
                  ]
                },
                "description": "**Enqueue a catalog export**\n\nStarts an async job that builds an immutable gzip NDJSON catalog artifact (same payload as GET /catalog/snapshot?format=ndjson). Poll GET /catalog/exports/{exportId} or subscribe to catalog.export_ready. Synchronous snapshot remains available.\n\nThe optional body `{\"pricing\": \"territory\"}` builds the export with every country price per shared SKU (`sharedSkus[].territoryPrices[]`), the payload of `GET /catalog/snapshot?pricing=territory`. An empty body builds the plain export, as before. On contract date `2026-12-01` and later a body that is not a JSON object, an unknown field or another `pricing` value answers `422 VALIDATION_FAILED`; earlier dates ignore a body they cannot use.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 202, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/catalog/exports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"pricing\": \"territory\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"exportId\": \"ff866d13-7ed1-4307-8659-ab3823affe2f\",\n    \"status\": \"pending\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/exports",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "exports"
                  ]
                },
                "description": "**Enqueue a catalog export**\n\nStarts an async job that builds an immutable gzip NDJSON catalog artifact (same payload as GET /catalog/snapshot?format=ndjson). Poll GET /catalog/exports/{exportId} or subscribe to catalog.export_ready. Synchronous snapshot remains available.\n\nThe optional body `{\"pricing\": \"territory\"}` builds the export with every country price per shared SKU (`sharedSkus[].territoryPrices[]`), the payload of `GET /catalog/snapshot?pricing=territory`. An empty body builds the plain export, as before. On contract date `2026-12-01` and later a body that is not a JSON object, an unknown field or another `pricing` value answers `422 VALIDATION_FAILED`; earlier dates ignore a body they cannot use.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 202, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/catalog/exports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"pricing\": \"territory\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Catalog export status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/catalog/exports/:exportId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "catalog",
                "exports",
                ":exportId"
              ],
              "variable": [
                {
                  "key": "exportId",
                  "value": "{{exportId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Catalog export status**\n\nJob status plus a short-lived signed download URL when the gzip NDJSON artifact is ready. 410 EXPORT_EXPIRED when the artifact TTL has elapsed.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 410, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/exports/{exportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Export status",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/exports/:exportId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "exports",
                    ":exportId"
                  ],
                  "variable": [
                    {
                      "key": "exportId",
                      "value": "{{exportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Catalog export status**\n\nJob status plus a short-lived signed download URL when the gzip NDJSON artifact is ready. 410 EXPORT_EXPIRED when the artifact TTL has elapsed.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 410, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/exports/{exportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"exportId\": \"a9a3fe03-9899-4a48-8f97-ddad55764aa5\",\n    \"status\": \"pending\",\n    \"checksum\": \"sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\",\n    \"bytes\": 1,\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"downloadUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"totalProducts\": 2450,\n    \"attempts\": 1,\n    \"pricing\": \"territory\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/catalog/exports/:exportId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "catalog",
                    "exports",
                    ":exportId"
                  ],
                  "variable": [
                    {
                      "key": "exportId",
                      "value": "{{exportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Catalog export status**\n\nJob status plus a short-lived signed download URL when the gzip NDJSON artifact is ready. 410 EXPORT_EXPIRED when the artifact TTL has elapsed.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 410, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/catalog/exports/{exportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"exportId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Partners",
      "description": "Connected publishers for the authenticated seller. Scope: `seller:products:read`.",
      "item": [
        {
          "name": "GET — List partners and connection requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/partners?limit=50&cursor=&status=active%2Cpending",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "partners"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "active,pending",
                  "description": "Comma-separated statuses to list: `active`, `suspended`, `terminating`, `terminated` (connections), `pending`, `rejected` (connection requests). Accepted on every contract date; an unknown value answers `422 VALIDATION_FAILED` (`details.issues[].field` is `status`). Without it the contract date decides: before `2026-12-01` `active,suspended,terminated`; from `2026-12-01` `active,suspended,terminating,terminated,pending`.",
                  "disabled": true
                }
              ]
            },
            "description": "**List partners and connection requests**\n\nThe vendors you are connected to, and your connection requests. Each connection row has the **connection** id and timestamps, invoicing flags, public **vendor** profile fields (`publisherWebsite`, `publisherCountry`, `publisherDescription`, `publisherLogoUrl`) and a read-only **`contracts`** summary (`activeBmaTypes`, `mcaStatus`, `catalogShareMode`, `sharesSuspended`) for pre-pull diagnostics. The full agreed terms of one connection are on `GET /partners/{connectionId}/agreements`.\n\n**Statuses.** A connection is `active`, `suspended`, `terminating` (notice period running; still live) or `terminated`. A connection request is `pending` (waiting for an answer: `connectionRequest.waitingOn` says whose) or `rejected`. A request row has no connection yet: its `connectionId` is the request id (the same value as `connectionRequest.requestId`), its `contracts` summary is empty, and once the vendor approves it the row is replaced by the connection row, with the connection's own id. A vendor can appear twice: a `terminated` connection and a new request. Requests are sent, answered and cancelled in the console; `connectionRequest.consoleUrl` opens the page.\n\n**`status` filter.** `status` (comma-separated) lists exactly the statuses named, on every contract date. Without it, contract dates before `2026-12-01` list `active`, `suspended` and `terminated` rows, as before; `2026-12-01` and later also list `terminating` and `pending` rows. `rejected` rows are listed only when `status` names them.\n\n**Vendor id.** `publisherCompanyId` is the value to pass as `partner` on `GET /products` and `GET /catalog/checksum`. It is a slug-safe company id (at most 32 characters), not a UUID; `connectionId` is not accepted there.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Partners and connection requests, most recently updated first",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners?limit=50&cursor=&status=active%2Cpending",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "active,pending",
                      "description": "Comma-separated statuses to list: `active`, `suspended`, `terminating`, `terminated` (connections), `pending`, `rejected` (connection requests). Accepted on every contract date; an unknown value answers `422 VALIDATION_FAILED` (`details.issues[].field` is `status`). Without it the contract date decides: before `2026-12-01` `active,suspended,terminated`; from `2026-12-01` `active,suspended,terminating,terminated,pending`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List partners and connection requests**\n\nThe vendors you are connected to, and your connection requests. Each connection row has the **connection** id and timestamps, invoicing flags, public **vendor** profile fields (`publisherWebsite`, `publisherCountry`, `publisherDescription`, `publisherLogoUrl`) and a read-only **`contracts`** summary (`activeBmaTypes`, `mcaStatus`, `catalogShareMode`, `sharesSuspended`) for pre-pull diagnostics. The full agreed terms of one connection are on `GET /partners/{connectionId}/agreements`.\n\n**Statuses.** A connection is `active`, `suspended`, `terminating` (notice period running; still live) or `terminated`. A connection request is `pending` (waiting for an answer: `connectionRequest.waitingOn` says whose) or `rejected`. A request row has no connection yet: its `connectionId` is the request id (the same value as `connectionRequest.requestId`), its `contracts` summary is empty, and once the vendor approves it the row is replaced by the connection row, with the connection's own id. A vendor can appear twice: a `terminated` connection and a new request. Requests are sent, answered and cancelled in the console; `connectionRequest.consoleUrl` opens the page.\n\n**`status` filter.** `status` (comma-separated) lists exactly the statuses named, on every contract date. Without it, contract dates before `2026-12-01` list `active`, `suspended` and `terminated` rows, as before; `2026-12-01` and later also list `terminating` and `pending` rows. `rejected` rows are listed only when `status` names them.\n\n**Vendor id.** `publisherCompanyId` is the value to pass as `partner` on `GET /products` and `GET /catalog/checksum`. It is a slug-safe company id (at most 32 characters), not a UUID; `connectionId` is not accepted there.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"connectionId\": \"80a031bc-cd1e-451a-8df6-7725083aa787\",\n      \"sellerCompanyId\": \"e21b6d10-7ff3-4d88-87b9-533ee13f\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"publisherCompanyName\": \"Acme Games\",\n      \"status\": \"active\",\n      \"connectionCreatedAt\": \"2026-11-02T09:30:00Z\",\n      \"connectionUpdatedAt\": \"2026-11-02T09:30:00Z\",\n      \"automatedSalesReportInvoicing\": true,\n      \"offboardingStatus\": \"none\",\n      \"terminationEffectiveAt\": \"2026-11-02T09:30:00Z\",\n      \"terminationInitiatedAt\": \"2026-11-02T09:30:00Z\",\n      \"terminatedBy\": null,\n      \"publisherWebsite\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherCountry\": \"DE\",\n      \"publisherDescription\": \"Example text.\",\n      \"publisherIndustry\": \"Video games\",\n      \"publisherCompanySize\": \"11-50\",\n      \"publisherRankingTier\": \"gold\",\n      \"publisherCompanyTypeCode\": \"vendor\",\n      \"publisherCompanyImageUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"publisherLogoUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n      \"contracts\": {\n        \"activeBmaTypes\": [\n          \"wholesale\"\n        ],\n        \"pendingBmaTypes\": [\n          \"wholesale\"\n        ],\n        \"pausedBmaTypes\": [\n          \"wholesale\"\n        ],\n        \"mcaStatus\": \"active\",\n        \"catalogShareMode\": \"all\",\n        \"sharesSuspended\": true,\n        \"activeTerms\": [\n          {\n            \"contractType\": \"mca\",\n            \"termId\": \"bbd50b36-7938-4345-8a05-28e4f048aea4\",\n            \"version\": 1,\n            \"effectiveAt\": \"2026-11-02T09:30:00Z\"\n          }\n        ],\n        \"pendingAmendmentCount\": 12,\n        \"lastContractChangeAt\": \"2026-11-02T09:30:00Z\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/partners?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners?limit=50&cursor=&status=active%2Cpending",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "active,pending",
                      "description": "Comma-separated statuses to list: `active`, `suspended`, `terminating`, `terminated` (connections), `pending`, `rejected` (connection requests). Accepted on every contract date; an unknown value answers `422 VALIDATION_FAILED` (`details.issues[].field` is `status`). Without it the contract date decides: before `2026-12-01` `active,suspended,terminated`; from `2026-12-01` `active,suspended,terminating,terminated,pending`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List partners and connection requests**\n\nThe vendors you are connected to, and your connection requests. Each connection row has the **connection** id and timestamps, invoicing flags, public **vendor** profile fields (`publisherWebsite`, `publisherCountry`, `publisherDescription`, `publisherLogoUrl`) and a read-only **`contracts`** summary (`activeBmaTypes`, `mcaStatus`, `catalogShareMode`, `sharesSuspended`) for pre-pull diagnostics. The full agreed terms of one connection are on `GET /partners/{connectionId}/agreements`.\n\n**Statuses.** A connection is `active`, `suspended`, `terminating` (notice period running; still live) or `terminated`. A connection request is `pending` (waiting for an answer: `connectionRequest.waitingOn` says whose) or `rejected`. A request row has no connection yet: its `connectionId` is the request id (the same value as `connectionRequest.requestId`), its `contracts` summary is empty, and once the vendor approves it the row is replaced by the connection row, with the connection's own id. A vendor can appear twice: a `terminated` connection and a new request. Requests are sent, answered and cancelled in the console; `connectionRequest.consoleUrl` opens the page.\n\n**`status` filter.** `status` (comma-separated) lists exactly the statuses named, on every contract date. Without it, contract dates before `2026-12-01` list `active`, `suspended` and `terminated` rows, as before; `2026-12-01` and later also list `terminating` and `pending` rows. `rejected` rows are listed only when `status` names them.\n\n**Vendor id.** `publisherCompanyId` is the value to pass as `partner` on `GET /products` and `GET /catalog/checksum`. It is a slug-safe company id (at most 32 characters), not a UUID; `connectionId` is not accepted there.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List pending title offers on a partner connection",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "partners",
                ":connectionId",
                "offers"
              ],
              "variable": [
                {
                  "key": "connectionId",
                  "value": "{{connectionId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**List pending title offers on a partner connection**\n\nTitles the vendor offered under your agreement that you have not accepted or declined yet. Read only: accept or decline in the console. Only offers on an active agreement are listed. Returns an empty list when nothing is pending. A connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/offers`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Pending title offers, oldest first",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/offers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners",
                    ":connectionId",
                    "offers"
                  ],
                  "variable": [
                    {
                      "key": "connectionId",
                      "value": "{{connectionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List pending title offers on a partner connection**\n\nTitles the vendor offered under your agreement that you have not accepted or declined yet. Read only: accept or decline in the console. Only offers on an active agreement are listed. Returns an empty list when nothing is pending. A connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/offers`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"amendmentId\": \"f641b878-6d57-46de-8e58-aeaadce91738\",\n      \"releaseId\": \"39f29ecc-4a66-475c-8562-63d56c6cf5fa\",\n      \"productId\": \"78a207ce-41e4-4f1a-893b-1c732f2f81fc\",\n      \"productName\": \"Example Game\",\n      \"editionName\": \"Standard Edition\",\n      \"platformName\": \"Steam\",\n      \"message\": \"Example text.\",\n      \"proposedAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/offers",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners",
                    ":connectionId",
                    "offers"
                  ],
                  "variable": [
                    {
                      "key": "connectionId",
                      "value": "{{connectionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List pending title offers on a partner connection**\n\nTitles the vendor offered under your agreement that you have not accepted or declined yet. Read only: accept or decline in the console. Only offers on an active agreement are listed. Returns an empty list when nothing is pending. A connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/offers`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"connectionId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List the agreed terms on a partner connection",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/agreements",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "partners",
                ":connectionId",
                "agreements"
              ],
              "variable": [
                {
                  "key": "connectionId",
                  "value": "{{connectionId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**List the agreed terms on a partner connection**\n\nThe agreements in force with this vendor (`active`, `terminating`) or suspended (`paused`): the master agreement (`mca`) and each business-model agreement (`api`, `revenue_share`, `wholesale`, `pre_order`), with dates, renewal, territory, your revenue share and the settlement terms. Read only: agreements are proposed, signed and changed in the console (`consoleUrl`). Agreements still being negotiated or waiting for a signature are not listed; `GET /partners` counts them in `contracts.pendingBmaTypes`.\n\n`territory` is the grant orders are checked against: the signed countries plus later extensions. `permittedSaleCurrencies` names the currency rule; the per-currency detail is on `GET /whoami` (`permittedCurrenciesByPublisher`). `contract.activated`, `contract.expiring`, `contract.expired`, `contract.terminated` and `contract.amendment_accepted` tell you when to read this again.\n\nA connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/agreements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Agreed terms: the master agreement first, then each business model",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/agreements",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners",
                    ":connectionId",
                    "agreements"
                  ],
                  "variable": [
                    {
                      "key": "connectionId",
                      "value": "{{connectionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List the agreed terms on a partner connection**\n\nThe agreements in force with this vendor (`active`, `terminating`) or suspended (`paused`): the master agreement (`mca`) and each business-model agreement (`api`, `revenue_share`, `wholesale`, `pre_order`), with dates, renewal, territory, your revenue share and the settlement terms. Read only: agreements are proposed, signed and changed in the console (`consoleUrl`). Agreements still being negotiated or waiting for a signature are not listed; `GET /partners` counts them in `contracts.pendingBmaTypes`.\n\n`territory` is the grant orders are checked against: the signed countries plus later extensions. `permittedSaleCurrencies` names the currency rule; the per-currency detail is on `GET /whoami` (`permittedCurrenciesByPublisher`). `contract.activated`, `contract.expiring`, `contract.expired`, `contract.terminated` and `contract.amendment_accepted` tell you when to read this again.\n\nA connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/agreements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"termId\": \"1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n      \"contractType\": \"mca\",\n      \"status\": \"active\",\n      \"version\": 1,\n      \"effectiveFrom\": \"2026-06-01T00:00:00.000Z\",\n      \"expiresAt\": null,\n      \"activatedAt\": \"2026-06-01T08:12:00.000Z\",\n      \"renewalPolicy\": \"none\",\n      \"terminationNoticeAt\": null,\n      \"terminationEffectiveAt\": null,\n      \"territory\": null,\n      \"sellerRevenueSharePercent\": null,\n      \"paymentCurrency\": null,\n      \"paymentTermsDays\": 30,\n      \"reportingFrequency\": \"monthly\",\n      \"reportingDeadlineDays\": 10,\n      \"permittedSaleCurrencies\": null,\n      \"consoleUrl\": \"https://app.avrix.io/network/partners/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/contracts?company=acme-store\"\n    },\n    {\n      \"termId\": \"2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a\",\n      \"contractType\": \"api\",\n      \"status\": \"active\",\n      \"version\": 2,\n      \"effectiveFrom\": \"2026-06-01T00:00:00.000Z\",\n      \"expiresAt\": \"2027-05-31T23:59:59.000Z\",\n      \"activatedAt\": \"2026-06-01T08:15:00.000Z\",\n      \"renewalPolicy\": \"auto_renew\",\n      \"terminationNoticeAt\": null,\n      \"terminationEffectiveAt\": null,\n      \"territory\": {\n        \"worldwide\": false,\n        \"countries\": [\n          \"BE\",\n          \"DE\",\n          \"FR\",\n          \"NL\"\n        ]\n      },\n      \"sellerRevenueSharePercent\": 25,\n      \"paymentCurrency\": \"EUR\",\n      \"paymentTermsDays\": 30,\n      \"reportingFrequency\": \"monthly\",\n      \"reportingDeadlineDays\": 10,\n      \"permittedSaleCurrencies\": \"primary_only\",\n      \"consoleUrl\": \"https://app.avrix.io/network/partners/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d/contracts?company=acme-store\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/partners/:connectionId/agreements",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "partners",
                    ":connectionId",
                    "agreements"
                  ],
                  "variable": [
                    {
                      "key": "connectionId",
                      "value": "{{connectionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List the agreed terms on a partner connection**\n\nThe agreements in force with this vendor (`active`, `terminating`) or suspended (`paused`): the master agreement (`mca`) and each business-model agreement (`api`, `revenue_share`, `wholesale`, `pre_order`), with dates, renewal, territory, your revenue share and the settlement terms. Read only: agreements are proposed, signed and changed in the console (`consoleUrl`). Agreements still being negotiated or waiting for a signature are not listed; `GET /partners` counts them in `contracts.pendingBmaTypes`.\n\n`territory` is the grant orders are checked against: the signed countries plus later extensions. `permittedSaleCurrencies` names the currency rule; the per-currency detail is on `GET /whoami` (`permittedCurrenciesByPublisher`). `contract.activated`, `contract.expiring`, `contract.expired`, `contract.terminated` and `contract.amendment_accepted` tell you when to read this again.\n\nA connection that is not yours, or the id of a connection request, returns 404.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/partners/{connectionId}/agreements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"connectionId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Access proposals",
      "description": "Offers from a Content Owner to widen the countries or the currency you may sell in. List them, then accept or decline each one. Accept and decline require `Idempotency-Key`. Scopes: any seller scope to list, `seller:account:manage` to answer.",
      "item": [
        {
          "name": "GET — List partner access proposals",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/access/proposals",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "access",
                "proposals"
              ]
            },
            "description": "**List partner access proposals**\n\nProposals from your Content Owners to widen what you may sell (more countries, another currency), waiting for your answer. Nothing changes until you accept. The same proposals appear per publisher under `whoami.accessByPublisher[].proposals`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/access/proposals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Open proposals, oldest first",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals"
                  ]
                },
                "description": "**List partner access proposals**\n\nProposals from your Content Owners to widen what you may sell (more countries, another currency), waiting for your answer. Nothing changes until you accept. The same proposals appear per publisher under `whoami.accessByPublisher[].proposals`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/access/proposals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"fe19cbc6-d16b-4b9a-8730-c3b86ec2ebf8\",\n      \"type\": \"territory_added\",\n      \"worldwide\": true,\n      \"countryCodes\": [\n        \"DE\"\n      ],\n      \"currencyCode\": \"EUR\",\n      \"reason\": null,\n      \"effectiveFrom\": \"2026-11-02T09:30:00Z\",\n      \"proposedAt\": \"2026-11-02T09:30:00Z\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"connectionId\": \"162f1e8d-4214-47b2-8599-3cf246db7de0\",\n      \"contractTermId\": \"dec7f681-420b-435e-80a8-a798bdcfc55e\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals"
                  ]
                },
                "description": "**List partner access proposals**\n\nProposals from your Content Owners to widen what you may sell (more countries, another currency), waiting for your answer. Nothing changes until you accept. The same proposals appear per publisher under `whoami.accessByPublisher[].proposals`.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/access/proposals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Accept a partner access proposal",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/accept",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "access",
                "proposals",
                ":id",
                "accept"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Accept a partner access proposal**\n\nAccept a Content Owner's proposal: the countries or the currency apply from now, or from the proposal's effectiveFrom if later. Checked again at acceptance: a currency must still be in the Content Owner's allowed currencies and convert to the agreement's payment currency at a reference rate from the last 14 days; a refusal names `details.accessCode` (ACCESS_FX_NOT_COVERED with `details.currencyPair`, ACCESS_CURRENCY_NOT_ALLOWED). Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Accepted",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/accept",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals",
                    ":id",
                    "accept"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Accept a partner access proposal**\n\nAccept a Content Owner's proposal: the countries or the currency apply from now, or from the proposal's effectiveFrom if later. Checked again at acceptance: a currency must still be in the Content Owner's allowed currencies and convert to the agreement's payment currency at a reference rate from the last 14 days; a refusal names `details.accessCode` (ACCESS_FX_NOT_COVERED with `details.currencyPair`, ACCESS_CURRENCY_NOT_ALLOWED). Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"a525c1e0-81cb-42d8-8922-81a4028474a4\",\n    \"status\": \"accepted\",\n    \"effectiveFrom\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/accept",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals",
                    ":id",
                    "accept"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Accept a partner access proposal**\n\nAccept a Content Owner's proposal: the countries or the currency apply from now, or from the proposal's effectiveFrom if later. Checked again at acceptance: a currency must still be in the Content Owner's allowed currencies and convert to the agreement's payment currency at a reference rate from the last 14 days; a refusal names `details.accessCode` (ACCESS_FX_NOT_COVERED with `details.currencyPair`, ACCESS_CURRENCY_NOT_ALLOWED). Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Decline a partner access proposal",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/decline",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "access",
                "proposals",
                ":id",
                "decline"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Decline a partner access proposal**\n\nDecline a Content Owner's proposal. Nothing changes; the Content Owner is told. Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Declined",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/decline",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals",
                    ":id",
                    "decline"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Decline a partner access proposal**\n\nDecline a Content Owner's proposal. Nothing changes; the Content Owner is told. Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"1618d5f8-69ec-4c02-898b-a2c368216199\",\n    \"status\": \"declined\",\n    \"effectiveFrom\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/access/proposals/:id/decline",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "access",
                    "proposals",
                    ":id",
                    "decline"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Decline a partner access proposal**\n\nDecline a Content Owner's proposal. Nothing changes; the Content Owner is told. Send an `Idempotency-Key` header (required). Requires `seller:account:manage`.\n\n**Scopes:** `seller:account:manage`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/access/proposals/{id}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Allocations",
      "description": "Allocation headroom per SKU (how many keys you can still pull under each partner contract). Short-lived per-company cache (~60s). Scope: `seller:products:read` to read; `seller:allocations:write` to request more stock or change top-up settings (`seller:orders:write` and the legacy `seller:keys:pull` also accepted).",
      "item": [
        {
          "name": "GET — List allocations",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations?sellableOnly=false&limit=50&cursor=&updatedSince=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations"
              ],
              "query": [
                {
                  "key": "sellableOnly",
                  "value": "false",
                  "description": "When true, return only allocations currently sellable for checkout (share, allocation, product, and pricing gates satisfied).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                  "disabled": true
                },
                {
                  "key": "updatedSince",
                  "value": "",
                  "description": "Delta polling: only grants mutated at/after this ISO 8601 instant. Use the max `updatedAt` you have stored as the next `updatedSince`; overlap by a few seconds to be safe. Full refetches are only needed on cold start. (ISO 8601)",
                  "disabled": true
                }
              ]
            },
            "description": "**List allocations**\n\nAllocations (quantity limits from publishers) with **commercial terms** for API checkout: `businessModel`, `pricePerKeyCents`, `currencyCode`, `paymentStatus`, and `productId` (links to `GET /products/{productId}` for full SKU/pricing detail). **List/catalog prices** (SRP) come from product list/detail and `.../pricing` routes; **per-key wholesale** is on each allocation, for the models that have one. Under `businessModel: api` there is no wholesale price: `pricePerKeyCents`, `currencyCode` and `currencyExponent` are `null` (never `0`) and the sale settles as a share of the territory list price, which every fulfilled pull records per key for finance (`https://docs.avrix.io/seller-api/store-profiles`).\n\nDelta polling: pass `updatedSince` with your last-seen max `updatedAt` to fetch only changed grants instead of a full refetch. Sellability embedded in catalog responses (`sharedSkus[].sellable`) is computed from these same grant rows, and grant mutations invalidate the cached catalog surfaces, so allocations and catalog readiness cannot drift apart for longer than one poll.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Allocations list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations?sellableOnly=false&limit=50&cursor=&updatedSince=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations"
                  ],
                  "query": [
                    {
                      "key": "sellableOnly",
                      "value": "false",
                      "description": "When true, return only allocations currently sellable for checkout (share, allocation, product, and pricing gates satisfied).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Delta polling: only grants mutated at/after this ISO 8601 instant. Use the max `updatedAt` you have stored as the next `updatedSince`; overlap by a few seconds to be safe. Full refetches are only needed on cold start. (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List allocations**\n\nAllocations (quantity limits from publishers) with **commercial terms** for API checkout: `businessModel`, `pricePerKeyCents`, `currencyCode`, `paymentStatus`, and `productId` (links to `GET /products/{productId}` for full SKU/pricing detail). **List/catalog prices** (SRP) come from product list/detail and `.../pricing` routes; **per-key wholesale** is on each allocation, for the models that have one. Under `businessModel: api` there is no wholesale price: `pricePerKeyCents`, `currencyCode` and `currencyExponent` are `null` (never `0`) and the sale settles as a share of the territory list price, which every fulfilled pull records per key for finance (`https://docs.avrix.io/seller-api/store-profiles`).\n\nDelta polling: pass `updatedSince` with your last-seen max `updatedAt` to fetch only changed grants instead of a full refetch. Sellability embedded in catalog responses (`sharedSkus[].sellable`) is computed from these same grant rows, and grant mutations invalidate the cached catalog surfaces, so allocations and catalog readiness cannot drift apart for longer than one poll.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"5f806eee-a091-4312-83c5-a9cd7f1bfd15\",\n      \"readableId\": \"alc_x7pxwyu8\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"publisherCompanyName\": \"Acme Games\",\n      \"productId\": \"7483d800-44ec-4ba3-8dca-a656b522eb0b\",\n      \"skuId\": \"cfeed4af-d1c8-420b-8b05-acd821519257\",\n      \"skuCode\": \"EXAMPLE-STEAM-WW\",\n      \"productName\": \"Example Game\",\n      \"quantityLimit\": 50,\n      \"quantityPulled\": 12,\n      \"remaining\": 12,\n      \"status\": \"active\",\n      \"businessModel\": \"api\",\n      \"paymentStatus\": \"not_required\",\n      \"pricePerKeyCents\": 2450,\n      \"currencyCode\": \"null\",\n      \"currencyExponent\": 2,\n      \"shareActive\": true,\n      \"catalogVisible\": true,\n      \"territoryPricingSet\": true,\n      \"sellable\": true,\n      \"readinessBlockers\": [\n        \"example_readinessblocker\"\n      ],\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"activation\": {\n        \"type\": \"worldwide\",\n        \"countries\": [\n          \"DE\"\n        ]\n      },\n      \"refundPolicy\": {\n        \"windowDays\": 1,\n        \"keyRevealForfeitsRefund\": true,\n        \"quarantineOnRefund\": true,\n        \"avrixMovesMoney\": false,\n        \"source\": \"platform\"\n      },\n      \"hotDropMode\": true,\n      \"launchWindow\": {\n        \"startsAt\": \"2026-11-02T09:30:00Z\",\n        \"endsAt\": \"2026-11-02T09:30:00Z\",\n        \"reservedQuantity\": 12,\n        \"state\": \"scheduled\",\n        \"setAside\": 1\n      },\n      \"consumerGeoAttestRequired\": true,\n      \"requestable\": true,\n      \"replenishment\": {\n        \"threshold\": 1,\n        \"quantity\": 12\n      },\n      \"keyless\": {\n        \"allowed\": true,\n        \"default\": true\n      },\n      \"buyerVerification\": {\n        \"level\": \"declared_ip\",\n        \"riskAction\": \"refuse\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/allocations?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true,\n    \"warnings\": [\n      {\n        \"code\": \"API_SKU_MISSING_CATALOG_PRICE\",\n        \"message\": \"Example text.\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations?sellableOnly=false&limit=50&cursor=&updatedSince=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations"
                  ],
                  "query": [
                    {
                      "key": "sellableOnly",
                      "value": "false",
                      "description": "When true, return only allocations currently sellable for checkout (share, allocation, product, and pricing gates satisfied).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Delta polling: only grants mutated at/after this ISO 8601 instant. Use the max `updatedAt` you have stored as the next `updatedSince`; overlap by a few seconds to be safe. Full refetches are only needed on cold start. (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List allocations**\n\nAllocations (quantity limits from publishers) with **commercial terms** for API checkout: `businessModel`, `pricePerKeyCents`, `currencyCode`, `paymentStatus`, and `productId` (links to `GET /products/{productId}` for full SKU/pricing detail). **List/catalog prices** (SRP) come from product list/detail and `.../pricing` routes; **per-key wholesale** is on each allocation, for the models that have one. Under `businessModel: api` there is no wholesale price: `pricePerKeyCents`, `currencyCode` and `currencyExponent` are `null` (never `0`) and the sale settles as a share of the territory list price, which every fulfilled pull records per key for finance (`https://docs.avrix.io/seller-api/store-profiles`).\n\nDelta polling: pass `updatedSince` with your last-seen max `updatedAt` to fetch only changed grants instead of a full refetch. Sellability embedded in catalog responses (`sharedSkus[].sellable`) is computed from these same grant rows, and grant mutations invalidate the cached catalog surfaces, so allocations and catalog readiness cannot drift apart for longer than one poll.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get one allocation",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get one allocation**\n\nOne of your allocations: the same row `GET /allocations` returns, whatever its status, so an allocation a webhook names can be read even when it is paused or revoked (the list shows active allocations only). 404 when the id is not one of your allocations.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The allocation",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get one allocation**\n\nOne of your allocations: the same row `GET /allocations` returns, whatever its status, so an allocation a webhook names can be read even when it is paused or revoked (the list shows active allocations only). 404 when the id is not one of your allocations.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"c36d1ab4-0849-49f4-8266-a904e35c099c\",\n    \"readableId\": \"alc_cdgev35u\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"publisherCompanyName\": \"Acme Games\",\n    \"productId\": \"347112d3-11a9-4a89-842c-ffa76c7d75e8\",\n    \"skuId\": \"e60cdfdf-a0ae-438a-8540-1a790e55e87b\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"productName\": \"Example Game\",\n    \"quantityLimit\": 50,\n    \"quantityPulled\": 12,\n    \"remaining\": 12,\n    \"status\": \"active\",\n    \"businessModel\": \"api\",\n    \"paymentStatus\": \"not_required\",\n    \"pricePerKeyMinor\": 2450,\n    \"currencyCode\": \"null\",\n    \"currencyExponent\": 2,\n    \"shareActive\": true,\n    \"catalogVisible\": true,\n    \"territoryPricingSet\": true,\n    \"sellable\": true,\n    \"readinessBlockers\": [\n      \"example_readinessblocker\"\n    ],\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"activation\": {\n      \"type\": \"worldwide\",\n      \"countries\": [\n        \"DE\"\n      ]\n    },\n    \"refundPolicy\": {\n      \"windowDays\": 1,\n      \"keyRevealForfeitsRefund\": true,\n      \"quarantineOnRefund\": true,\n      \"avrixMovesMoney\": false,\n      \"source\": \"platform\",\n      \"revealedKeysRefundable\": true\n    },\n    \"hotDropMode\": true,\n    \"launchWindow\": {\n      \"startsAt\": \"2026-11-02T09:30:00Z\",\n      \"endsAt\": \"2026-11-02T09:30:00Z\",\n      \"reservedQuantity\": 12,\n      \"state\": \"scheduled\",\n      \"setAside\": 1\n    },\n    \"consumerGeoAttestRequired\": true,\n    \"requestable\": true,\n    \"replenishment\": {\n      \"threshold\": 1,\n      \"quantity\": 12\n    },\n    \"keyless\": {\n      \"allowed\": true,\n      \"default\": true\n    },\n    \"buyerVerification\": {\n      \"level\": \"declared_ip\",\n      \"riskAction\": \"refuse\"\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get one allocation**\n\nOne of your allocations: the same row `GET /allocations` returns, whatever its status, so an allocation a webhook names can be read even when it is paused or revoked (the list shows active allocations only). 404 when the id is not one of your allocations.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "PATCH — Set the automatic top-up trigger",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Set the automatic top-up trigger**\n\nSet or clear the low-stock threshold of one of your allocations (`replenishThreshold`; null = off) and the top-up you want (`replenishQuantity`; null = the Content Owner's maximum). When a pull leaves `remaining` at or below the threshold, Avrix tops the allocation up within the Content Owner's rules (`allocation.replenished`) or files an allocation request for them to review (the manual path). A threshold that is already crossed is checked at once. `Idempotency-Key` is optional. The answer also returns the Content Owner's top-up `rules` and `effective`: what a crossing will do under them (top up at once, file a request, or nothing), so a threshold the rules will not honour is visible when you set it. On contract date `2026-12-01` and later a revoked allocation is refused with 409 `CONFLICT` (`details.reason: allocation_revoked`); earlier dates save it, and it never fires.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same allocations. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"replenishThreshold\": null,\n  \"replenishQuantity\": null\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Saved",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Set the automatic top-up trigger**\n\nSet or clear the low-stock threshold of one of your allocations (`replenishThreshold`; null = off) and the top-up you want (`replenishQuantity`; null = the Content Owner's maximum). When a pull leaves `remaining` at or below the threshold, Avrix tops the allocation up within the Content Owner's rules (`allocation.replenished`) or files an allocation request for them to review (the manual path). A threshold that is already crossed is checked at once. `Idempotency-Key` is optional. The answer also returns the Content Owner's top-up `rules` and `effective`: what a crossing will do under them (top up at once, file a request, or nothing), so a threshold the rules will not honour is visible when you set it. On contract date `2026-12-01` and later a revoked allocation is refused with 409 `CONFLICT` (`details.reason: allocation_revoked`); earlier dates save it, and it never fires.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same allocations. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"replenishThreshold\": null,\n  \"replenishQuantity\": null\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"allocationId\": \"de3bf764-8ac2-4795-8b5f-00028594099e\",\n    \"replenishment\": {\n      \"threshold\": 1,\n      \"quantity\": 12\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Set the automatic top-up trigger**\n\nSet or clear the low-stock threshold of one of your allocations (`replenishThreshold`; null = off) and the top-up you want (`replenishQuantity`; null = the Content Owner's maximum). When a pull leaves `remaining` at or below the threshold, Avrix tops the allocation up within the Content Owner's rules (`allocation.replenished`) or files an allocation request for them to review (the manual path). A threshold that is already crossed is checked at once. `Idempotency-Key` is optional. The answer also returns the Content Owner's top-up `rules` and `effective`: what a crossing will do under them (top up at once, file a request, or nothing), so a threshold the rules will not honour is visible when you set it. On contract date `2026-12-01` and later a revoked allocation is refused with 409 `CONFLICT` (`details.reason: allocation_revoked`); earlier dates save it, and it never fires.\n\n**Shared sandbox (contract date `2026-12-01` and later):** a sandbox key on the shared sandbox gets **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED` and nothing changes, because every store there shares the same allocations. Earlier contract dates still run the write. Production keys and isolated sandbox environments are not affected.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/allocations/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"replenishThreshold\": null,\n  \"replenishQuantity\": null\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Automatic top-up history",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/:id/replenishments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                ":id",
                "replenishments"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Automatic top-up history**\n\nYour top-up trigger on the allocation, the Content Owner's rules for it, and every automatic top-up (`auto_replenished`) or request filed outside the rules (`auto_replenish_requested`), newest first. The Content Owner sees the same history. `effective` says what a crossing does under the rules. A read that fails answers 500, 503 or 504 (with `Retry-After` on 503/504), never 404 or an empty history.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}/replenishments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 History",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id/replenishments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id",
                    "replenishments"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Automatic top-up history**\n\nYour top-up trigger on the allocation, the Content Owner's rules for it, and every automatic top-up (`auto_replenished`) or request filed outside the rules (`auto_replenish_requested`), newest first. The Content Owner sees the same history. `effective` says what a crossing does under the rules. A read that fails answers 500, 503 or 504 (with `Retry-After` on 503/504), never 404 or an empty history.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}/replenishments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"allocationId\": \"63443ec2-dfe3-4b6f-825d-eab329152d71\",\n    \"replenishment\": {\n      \"threshold\": 1,\n      \"quantity\": 12\n    },\n    \"rules\": {\n      \"automatic\": true,\n      \"maxQuantity\": 12,\n      \"minIntervalHours\": 1,\n      \"ceilingCap\": 12\n    },\n    \"history\": [\n      {\n        \"type\": \"auto_replenished\",\n        \"quantity\": 12,\n        \"occurredAt\": \"2026-11-02T09:30:00Z\",\n        \"details\": {}\n      }\n    ]\n  },\n  \"meta\": {\n    \"requestId\": \"421d84b8-784e-4676-87b8-9c30653c65e2\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/:id/replenishments",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    ":id",
                    "replenishments"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Automatic top-up history**\n\nYour top-up trigger on the allocation, the Content Owner's rules for it, and every automatic top-up (`auto_replenished`) or request filed outside the rules (`auto_replenish_requested`), newest first. The Content Owner sees the same history. `effective` says what a crossing does under the rules. A read that fails answers 500, 503 or 504 (with `Retry-After` on 503/504), never 404 or an empty history.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/{id}/replenishments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List allocation requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/requests?limit=100&cursor=&state=pending%2Cbackordered&allocationId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                "requests"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "100",
                  "description": "Page size (1-100, default 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                  "disabled": true
                },
                {
                  "key": "state",
                  "value": "pending,backordered",
                  "description": "Only requests in these states, comma-separated: `pending`, `auto_granted`, `approved`, `denied`, `backordered`, `cancelled`.",
                  "disabled": true
                },
                {
                  "key": "allocationId",
                  "value": "",
                  "description": "Only requests for this allocation. (UUID)",
                  "disabled": true
                }
              ]
            },
            "description": "**List allocation requests**\n\nAllocation requests you filed, newest first. Page with `limit` and `cursor` until `meta.nextCursor` is null (the list contract on `https://docs.avrix.io/seller-api/pagination`). Without `limit` a page holds up to 100 rows. Filter with `state` (one or more, comma-separated) and `allocationId`. Read one request with `GET /allocations/requests/{id}`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Request list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests?limit=100&cursor=&state=pending%2Cbackordered&allocationId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "100",
                      "description": "Page size (1-100, default 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "state",
                      "value": "pending,backordered",
                      "description": "Only requests in these states, comma-separated: `pending`, `auto_granted`, `approved`, `denied`, `backordered`, `cancelled`.",
                      "disabled": true
                    },
                    {
                      "key": "allocationId",
                      "value": "",
                      "description": "Only requests for this allocation. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List allocation requests**\n\nAllocation requests you filed, newest first. Page with `limit` and `cursor` until `meta.nextCursor` is null (the list contract on `https://docs.avrix.io/seller-api/pagination`). Without `limit` a page holds up to 100 rows. Filter with `state` (one or more, comma-separated) and `allocationId`. Read one request with `GET /allocations/requests/{id}`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"042e2592-3d48-4912-8aa7-524b5bfbe2c7\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"sellerCompanyId\": \"8f0e747d-36c4-4b3a-842c-3d72959430a3\",\n      \"skuId\": \"67ce1fb9-ff07-4dcc-8793-eba855dc8a58\",\n      \"businessModel\": \"wholesale\",\n      \"allocationGrantId\": \"06d3443d-c78a-47c2-828f-a126e4d9b5f4\",\n      \"requestedQuantity\": 12,\n      \"declaredForecast\": 1,\n      \"status\": \"pending\",\n      \"resolution\": \"auto_granted\",\n      \"resolvedGrantDelta\": 1,\n      \"resolvedBy\": null,\n      \"resolvedAt\": \"2026-11-02T09:30:00Z\",\n      \"decisionNote\": \"Example text.\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"allocationId\": \"e7dc9a4f-91b5-4e7b-8c7a-31ba8084a32d\",\n      \"state\": \"pending\",\n      \"updatedAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/example?cursor=eyJ2IjoyfQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests?limit=100&cursor=&state=pending%2Cbackordered&allocationId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "100",
                      "description": "Page size (1-100, default 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor` of the previous page. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "state",
                      "value": "pending,backordered",
                      "description": "Only requests in these states, comma-separated: `pending`, `auto_granted`, `approved`, `denied`, `backordered`, `cancelled`.",
                      "disabled": true
                    },
                    {
                      "key": "allocationId",
                      "value": "",
                      "description": "Only requests for this allocation. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List allocation requests**\n\nAllocation requests you filed, newest first. Page with `limit` and `cursor` until `meta.nextCursor` is null (the list contract on `https://docs.avrix.io/seller-api/pagination`). Without `limit` a page holds up to 100 rows. Filter with `state` (one or more, comma-separated) and `allocationId`. Read one request with `GET /allocations/requests/{id}`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Create allocation request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/requests",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                "requests"
              ]
            },
            "description": "**Create allocation request**\n\nAsk the Content Owner for more keys on one of your allocations. Name the allocation with `allocationId` (`grantId` is the older name of the same field and stays accepted; send one, or both with the same value). The Content Owner's rules may grant it at once (`resolution: auto_granted`); otherwise it waits for them (`pending_review`) and `allocation.request_decided` tells you the outcome. Their free stock is read on the server; `publisherAvailableKeys` is accepted for compatibility and ignored. One pending request per allocation: a second answers 409 with `details.pendingRequestId`. Withdraw a pending request with `POST /allocations/requests/{id}/cancel`; to change the quantity, cancel and file a new one. **Status:** 200 before contract date `2026-12-01`; 201 on `2026-12-01` and later, with the same body. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. An automatic grant is checked against the vendor's auto-grant cap when it is applied; a request that would take the grant past the cap stays pending for the vendor.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"allocationId\": \"3f1c2a9e-8b7d-4c6e-9a10-5d2e7b4f8c21\",\n  \"requestedQuantity\": 100,\n  \"declaredForecast\": 250\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Request filed or granted at once (contract dates before `2026-12-01`).",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests"
                  ]
                },
                "description": "**Create allocation request**\n\nAsk the Content Owner for more keys on one of your allocations. Name the allocation with `allocationId` (`grantId` is the older name of the same field and stays accepted; send one, or both with the same value). The Content Owner's rules may grant it at once (`resolution: auto_granted`); otherwise it waits for them (`pending_review`) and `allocation.request_decided` tells you the outcome. Their free stock is read on the server; `publisherAvailableKeys` is accepted for compatibility and ignored. One pending request per allocation: a second answers 409 with `details.pendingRequestId`. Withdraw a pending request with `POST /allocations/requests/{id}/cancel`; to change the quantity, cancel and file a new one. **Status:** 200 before contract date `2026-12-01`; 201 on `2026-12-01` and later, with the same body. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. An automatic grant is checked against the vendor's auto-grant cap when it is applied; a request that would take the grant past the cap stays pending for the vendor.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allocationId\": \"3f1c2a9e-8b7d-4c6e-9a10-5d2e7b4f8c21\",\n  \"requestedQuantity\": 100,\n  \"declaredForecast\": 250\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"requestId\": \"40193189-7864-4b21-8d70-08120597f7cc\",\n    \"resolution\": \"auto_granted\",\n    \"grantDelta\": 1,\n    \"allocationId\": \"1164918c-d613-4ea6-8aca-ba348968b285\",\n    \"state\": \"pending\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests"
                  ]
                },
                "description": "**Create allocation request**\n\nAsk the Content Owner for more keys on one of your allocations. Name the allocation with `allocationId` (`grantId` is the older name of the same field and stays accepted; send one, or both with the same value). The Content Owner's rules may grant it at once (`resolution: auto_granted`); otherwise it waits for them (`pending_review`) and `allocation.request_decided` tells you the outcome. Their free stock is read on the server; `publisherAvailableKeys` is accepted for compatibility and ignored. One pending request per allocation: a second answers 409 with `details.pendingRequestId`. Withdraw a pending request with `POST /allocations/requests/{id}/cancel`; to change the quantity, cancel and file a new one. **Status:** 200 before contract date `2026-12-01`; 201 on `2026-12-01` and later, with the same body. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. An automatic grant is checked against the vendor's auto-grant cap when it is applied; a request that would take the grant past the cap stays pending for the vendor.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allocationId\": \"3f1c2a9e-8b7d-4c6e-9a10-5d2e7b4f8c21\",\n  \"requestedQuantity\": 100,\n  \"declaredForecast\": 250\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Get one allocation request",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                "requests",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get one allocation request**\n\nOne allocation request you filed, in any state. 404 when the id is not one of your requests.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The request",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get one allocation request**\n\nOne allocation request you filed, in any state. 404 when the id is not one of your requests.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"4bff5aa2-75d9-47ba-8847-9d507987a944\",\n    \"state\": \"pending\",\n    \"allocationId\": \"b658872f-49eb-4f71-8416-262e4c883e51\",\n    \"allocationGrantId\": \"bba01716-cce8-49a4-8aff-8197e267e7f5\",\n    \"skuId\": \"02d4f1b0-4cf3-4c63-8ed5-dc730831296f\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"sellerCompanyId\": \"d0685bec-cd5f-44dc-8a15-2b1dda048afb\",\n    \"businessModel\": \"wholesale\",\n    \"requestedQuantity\": 12,\n    \"declaredForecast\": 1,\n    \"status\": \"pending\",\n    \"resolution\": \"auto_granted\",\n    \"resolvedGrantDelta\": 1,\n    \"resolvedBy\": \"example_resolvedby\",\n    \"resolvedAt\": \"2026-11-02T09:30:00Z\",\n    \"decisionNote\": \"Example text.\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get one allocation request**\n\nOne allocation request you filed, in any state. 404 when the id is not one of your requests.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/allocations/requests/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Cancel an allocation request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "allocations",
                "requests",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Cancel an allocation request**\n\nWithdraw a pending allocation request before the Content Owner decides it. The answer is the request with `state: cancelled`; cancelling a request that is already cancelled answers the same 200, so a retry is safe. A request the Content Owner already decided answers 409 (`details.reason: ALLOCATION_REQUEST_ALREADY_RESOLVED`, `details.state`). Sends `allocation.request_cancelled`. There is no amend: cancel, then file a new request. No body. `Idempotency-Key` is optional.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests/{id}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Cancelled (or already cancelled)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests",
                    ":id",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Cancel an allocation request**\n\nWithdraw a pending allocation request before the Content Owner decides it. The answer is the request with `state: cancelled`; cancelling a request that is already cancelled answers the same 200, so a retry is safe. A request the Content Owner already decided answers 409 (`details.reason: ALLOCATION_REQUEST_ALREADY_RESOLVED`, `details.state`). Sends `allocation.request_cancelled`. There is no amend: cancel, then file a new request. No body. `Idempotency-Key` is optional.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests/{id}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"3585a03a-c870-4965-810a-a854782c0f89\",\n    \"state\": \"pending\",\n    \"allocationId\": \"5b6333bc-96f2-4462-8c9f-70eefd8c244f\",\n    \"allocationGrantId\": \"7f2b61ef-4f72-474f-8b29-10ee1bb3e1ad\",\n    \"skuId\": \"7bb644c9-aded-427f-8da2-48d0150cd7d3\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"sellerCompanyId\": \"faf08228-1733-4641-8dfc-6649bba40798\",\n    \"businessModel\": \"wholesale\",\n    \"requestedQuantity\": 12,\n    \"declaredForecast\": 1,\n    \"status\": \"pending\",\n    \"resolution\": \"auto_granted\",\n    \"resolvedGrantDelta\": 1,\n    \"resolvedBy\": \"example_resolvedby\",\n    \"resolvedAt\": \"2026-11-02T09:30:00Z\",\n    \"decisionNote\": \"Example text.\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/allocations/requests/:id/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "allocations",
                    "requests",
                    ":id",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Cancel an allocation request**\n\nWithdraw a pending allocation request before the Content Owner decides it. The answer is the request with `state: cancelled`; cancelling a request that is already cancelled answers the same 200, so a retry is safe. A request the Content Owner already decided answers 409 (`details.reason: ALLOCATION_REQUEST_ALREADY_RESOLVED`, `details.state`). Sends `allocation.request_cancelled`. There is no amend: cancel, then file a new request. No body. `Idempotency-Key` is optional.\n\n**Scopes (any one of):** `seller:allocations:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/allocations/requests/{id}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Availability",
      "description": "Pre-order readiness and real-time stock for a SKU. `available = min(allocationRemaining, inventoryAvailable)` — use before creating an order to fail fast.",
      "item": [
        {
          "name": "GET — Check availability",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/availability?skuCode=&skuId=&skuCodes=&quantity=&countryCode=&country=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "availability"
              ],
              "query": [
                {
                  "key": "skuCode",
                  "value": "",
                  "description": "Single SKU code",
                  "disabled": true
                },
                {
                  "key": "skuId",
                  "value": "",
                  "description": "Single SKU ID (UUID)",
                  "disabled": true
                },
                {
                  "key": "skuCodes",
                  "value": "",
                  "description": "Comma-separated SKU codes for bulk check (max 50)",
                  "disabled": true
                },
                {
                  "key": "quantity",
                  "value": "",
                  "description": "Single-mode only: when set, response includes `canFulfill` and `partialFulfillmentExpected` for this quantity (1–1000)",
                  "disabled": true
                },
                {
                  "key": "countryCode",
                  "value": "",
                  "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                  "disabled": true
                },
                {
                  "key": "country",
                  "value": "",
                  "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                  "disabled": true
                }
              ]
            },
            "description": "**Check availability**\n\nStock availability for a SKU or multiple SKUs. Single: use skuCode or skuId. Bulk: use skuCodes (comma-separated, max 50). Returns available (pullable), allocationRemaining, inventoryAvailable (sum of dedicatedAvailable + sharedPoolAvailable), and backorderEligible.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Availability data (single object or array for bulk)",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability?skuCode=&skuId=&skuCodes=&quantity=&countryCode=&country=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability"
                  ],
                  "query": [
                    {
                      "key": "skuCode",
                      "value": "",
                      "description": "Single SKU code",
                      "disabled": true
                    },
                    {
                      "key": "skuId",
                      "value": "",
                      "description": "Single SKU ID (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "skuCodes",
                      "value": "",
                      "description": "Comma-separated SKU codes for bulk check (max 50)",
                      "disabled": true
                    },
                    {
                      "key": "quantity",
                      "value": "",
                      "description": "Single-mode only: when set, response includes `canFulfill` and `partialFulfillmentExpected` for this quantity (1–1000)",
                      "disabled": true
                    },
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Check availability**\n\nStock availability for a SKU or multiple SKUs. Single: use skuCode or skuId. Bulk: use skuCodes (comma-separated, max 50). Returns available (pullable), allocationRemaining, inventoryAvailable (sum of dedicatedAvailable + sharedPoolAvailable), and backorderEligible.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"available\": 12,\n    \"allocationRemaining\": 12,\n    \"inventoryAvailable\": 12,\n    \"allocationId\": \"95a3f5dc-9d83-4ee5-85fd-b61c1dfc8f4e\",\n    \"allocationReadableId\": \"alc_adg79ecg\",\n    \"skuId\": \"dc5ece9b-d119-4c22-87e3-b91c6f2c8768\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"heldQuantity\": 12,\n    \"sellableNow\": 12,\n    \"maxFulfillableQuantity\": 12,\n    \"cannotFullyFulfill\": true,\n    \"allOrNothingWillFail\": true,\n    \"requestable\": true,\n    \"backordered\": true,\n    \"country\": \"DE\",\n    \"dedicatedAvailable\": 12,\n    \"sharedPoolAvailable\": 12,\n    \"backorderEligible\": true\n  },\n  \"meta\": {\n    \"requestId\": \"b988a31b-ad87-41a3-896e-dc0bddc07fd5\",\n    \"notFound\": [\n      \"example_notfound\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability?skuCode=&skuId=&skuCodes=&quantity=&countryCode=&country=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability"
                  ],
                  "query": [
                    {
                      "key": "skuCode",
                      "value": "",
                      "description": "Single SKU code",
                      "disabled": true
                    },
                    {
                      "key": "skuId",
                      "value": "",
                      "description": "Single SKU ID (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "skuCodes",
                      "value": "",
                      "description": "Comma-separated SKU codes for bulk check (max 50)",
                      "disabled": true
                    },
                    {
                      "key": "quantity",
                      "value": "",
                      "description": "Single-mode only: when set, response includes `canFulfill` and `partialFulfillmentExpected` for this quantity (1–1000)",
                      "disabled": true
                    },
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Check availability**\n\nStock availability for a SKU or multiple SKUs. Single: use skuCode or skuId. Bulk: use skuCodes (comma-separated, max 50). Returns available (pullable), allocationRemaining, inventoryAvailable (sum of dedicatedAvailable + sharedPoolAvailable), and backorderEligible.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Availability change feed",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/availability/changes?cursor=&limit=500",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "availability",
                "changes"
              ],
              "query": [
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque position from `meta.nextCursor` or the snapshot's `meta.availabilityCursor`. Returns entries strictly after it; omit to read from the start of the retained feed. A `/catalog/changes` cursor is refused (422).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "500",
                  "description": "Maximum entries to return (default 500, max 5000) (1–5000)",
                  "disabled": true
                }
              ]
            },
            "description": "**Availability change feed**\n\nPer-seller cursor feed of availability changes, so a mirror keeps stock and Buy buttons current without calling `GET /availability` per SKU.\n\n- `stock_down` / `stock_up`: one allocation's remaining count moved (order, return, resize, top-up). `remaining` is the count after the change.\n- `unsellable` / `sellable`: the SKU crossed the sellable boundary for you (same readiness as `GET /allocations`); `reasons` lists the blockers. The same transitions are pushed as `sku.sellability_changed`.\n\nA state is recorded once: an unchanged count or sellability writes no entry.\n\n**Cursor loop:** start from the snapshot's `meta.availabilityCursor`, pass it as `cursor`, apply the page, persist `meta.nextCursor` and poll again right away while `meta.hasMore` is true. At the head the cursor you sent comes back unchanged. The feed is advisory; order preview and commit remain the authority.\n\n**Retention:** at least 30 days, like `GET /catalog/changes`. On contract date `2026-12-01` and later a `cursor` beyond retention is answered `409 CATALOG_RESYNC_REQUIRED`.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Availability changes",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability/changes?cursor=&limit=500",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability",
                    "changes"
                  ],
                  "query": [
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor` or the snapshot's `meta.availabilityCursor`. Returns entries strictly after it; omit to read from the start of the retained feed. A `/catalog/changes` cursor is refused (422).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Maximum entries to return (default 500, max 5000) (1–5000)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Availability change feed**\n\nPer-seller cursor feed of availability changes, so a mirror keeps stock and Buy buttons current without calling `GET /availability` per SKU.\n\n- `stock_down` / `stock_up`: one allocation's remaining count moved (order, return, resize, top-up). `remaining` is the count after the change.\n- `unsellable` / `sellable`: the SKU crossed the sellable boundary for you (same readiness as `GET /allocations`); `reasons` lists the blockers. The same transitions are pushed as `sku.sellability_changed`.\n\nA state is recorded once: an unchanged count or sellability writes no entry.\n\n**Cursor loop:** start from the snapshot's `meta.availabilityCursor`, pass it as `cursor`, apply the page, persist `meta.nextCursor` and poll again right away while `meta.hasMore` is true. At the head the cursor you sent comes back unchanged. The feed is advisory; order preview and commit remain the authority.\n\n**Retention:** at least 30 days, like `GET /catalog/changes`. On contract date `2026-12-01` and later a `cursor` beyond retention is answered `409 CATALOG_RESYNC_REQUIRED`.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"changes\": [\n      {\n        \"skuId\": \"00441f16-3d2c-4024-8cd9-9d8072c03562\",\n        \"skuCode\": \"EXAMPLE-STEAM-WW\",\n        \"productId\": \"c5e89940-5398-4936-8230-d76126110948\",\n        \"allocationId\": \"7e6893d4-763f-458a-8186-61cdb11cc83d\",\n        \"type\": \"stock_up\",\n        \"remaining\": 12,\n        \"reasons\": [],\n        \"occurredAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ]\n  },\n  \"meta\": {\n    \"requestId\": \"29d4d5f7-46ff-49d2-8884-57806233f58f\",\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true,\n    \"limit\": 50,\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/availability/changes?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability/changes?cursor=&limit=500",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability",
                    "changes"
                  ],
                  "query": [
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor` or the snapshot's `meta.availabilityCursor`. Returns entries strictly after it; omit to read from the start of the retained feed. A `/catalog/changes` cursor is refused (422).",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Maximum entries to return (default 500, max 5000) (1–5000)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Availability change feed**\n\nPer-seller cursor feed of availability changes, so a mirror keeps stock and Buy buttons current without calling `GET /availability` per SKU.\n\n- `stock_down` / `stock_up`: one allocation's remaining count moved (order, return, resize, top-up). `remaining` is the count after the change.\n- `unsellable` / `sellable`: the SKU crossed the sellable boundary for you (same readiness as `GET /allocations`); `reasons` lists the blockers. The same transitions are pushed as `sku.sellability_changed`.\n\nA state is recorded once: an unchanged count or sellability writes no entry.\n\n**Cursor loop:** start from the snapshot's `meta.availabilityCursor`, pass it as `cursor`, apply the page, persist `meta.nextCursor` and poll again right away while `meta.hasMore` is true. At the head the cursor you sent comes back unchanged. The feed is advisory; order preview and commit remain the authority.\n\n**Retention:** at least 30 days, like `GET /catalog/changes`. On contract date `2026-12-01` and later a `cursor` beyond retention is answered `409 CATALOG_RESYNC_REQUIRED`.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/changes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Availability by SKU code",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/availability/:skuCode?countryCode=&country=&quantity=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "availability",
                ":skuCode"
              ],
              "query": [
                {
                  "key": "countryCode",
                  "value": "",
                  "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                  "disabled": true
                },
                {
                  "key": "country",
                  "value": "",
                  "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                  "disabled": true
                },
                {
                  "key": "quantity",
                  "value": "",
                  "description": "Optional quantity to check: the response says whether that many keys can be sold now. (min 1)",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "skuCode",
                  "value": "{{skuCode}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Availability by SKU code**\n\nSingle-SKU alias over `GET /availability`. Cacheable by your own HTTP cache via `Authorization` + `Accept-Language` (no shared CDN cache). Returns allocation + inventory headroom.\n\n**Bundles:** includes `skuType` + `bundleItems` when configured.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/{skuCode}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Availability row",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability/:skuCode?countryCode=&country=&quantity=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability",
                    ":skuCode"
                  ],
                  "query": [
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    },
                    {
                      "key": "quantity",
                      "value": "",
                      "description": "Optional quantity to check: the response says whether that many keys can be sold now. (min 1)",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "skuCode",
                      "value": "{{skuCode}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Availability by SKU code**\n\nSingle-SKU alias over `GET /availability`. Cacheable by your own HTTP cache via `Authorization` + `Accept-Language` (no shared CDN cache). Returns allocation + inventory headroom.\n\n**Bundles:** includes `skuType` + `bundleItems` when configured.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/{skuCode}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"available\": 12,\n    \"allocationRemaining\": 12,\n    \"inventoryAvailable\": 12,\n    \"allocationId\": \"cf56d0af-ff29-4d57-8a54-a2b309cbfe57\",\n    \"allocationReadableId\": \"alc_sjp8rabm\",\n    \"skuId\": \"bd0749e8-231f-42d6-8436-64684772e184\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"heldQuantity\": 12,\n    \"sellableNow\": 12,\n    \"maxFulfillableQuantity\": 12,\n    \"cannotFullyFulfill\": true,\n    \"allOrNothingWillFail\": true,\n    \"requestable\": true,\n    \"backordered\": true,\n    \"country\": \"DE\",\n    \"dedicatedAvailable\": 12,\n    \"sharedPoolAvailable\": 12,\n    \"backorderEligible\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/availability/:skuCode?countryCode=&country=&quantity=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "availability",
                    ":skuCode"
                  ],
                  "query": [
                    {
                      "key": "countryCode",
                      "value": "",
                      "description": "Optional single ISO 3166-1 alpha-2 code (e.g. `DE`) — the canonical spelling, matching the checkout field name. When present, each availability item also carries `country`, `sellableInCountry`, and `blockedReason` (`COUNTRY_RESTRICTED`, `TERRITORY_NOT_ALLOWED_FOR_SKU`, `TERRITORY_EXCLUDED_FOR_RELEASE`, `SKU_REGION_UNRESOLVED`, or `CATALOG_PRICE_NOT_SET`) evaluated with the same territory predicate as `POST /orders/preview`.",
                      "disabled": true
                    },
                    {
                      "key": "country",
                      "value": "",
                      "description": "Alias of `countryCode` (the original availability spelling, still accepted). Sending both with different values fails validation; a request that uses only this spelling gets an `X-Avrix-Deprecated-Parameter` response header naming the replacement.",
                      "disabled": true
                    },
                    {
                      "key": "quantity",
                      "value": "",
                      "description": "Optional quantity to check: the response says whether that many keys can be sold now. (min 1)",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "skuCode",
                      "value": "{{skuCode}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Availability by SKU code**\n\nSingle-SKU alias over `GET /availability`. Cacheable by your own HTTP cache via `Authorization` + `Accept-Language` (no shared CDN cache). Returns allocation + inventory headroom.\n\n**Bundles:** includes `skuType` + `bundleItems` when configured.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/availability/{skuCode}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"skuCode\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Transactions",
      "description": "Key pull history (cursor-paginated). Use for reconciliation against your store's order ledger. Scope: `seller:orders:read` (also `seller:orders:write`; legacy `seller:products:read`, `seller:keys:pull`).",
      "item": [
        {
          "name": "GET — List transactions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/transactions?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "transactions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                  "disabled": true
                },
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Return only transactions with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                  "disabled": true
                },
                {
                  "key": "parentOrderReference",
                  "value": "",
                  "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                  "disabled": true
                }
              ]
            },
            "description": "**List transactions**\n\n**Deprecated name.** Use `GET /keys/pulls`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nKey pull history. Paginated. Filter by from/to (ISO 8601 date range) for analytics and reporting. When `meta.hasMore` is true, `meta.nextUrl` is the full URL for the next page (same filters; cursor updated).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/transactions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Transactions list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/transactions?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Return only transactions with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List transactions**\n\n**Deprecated name.** Use `GET /keys/pulls`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nKey pull history. Paginated. Filter by from/to (ISO 8601 date range) for analytics and reporting. When `meta.hasMore` is true, `meta.nextUrl` is the full URL for the next page (same filters; cursor updated).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/transactions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"b5c89009-cbb4-4656-8d72-ba97b8ba9da7\",\n      \"readableId\": \"ord_cpwewsg2\",\n      \"allocationId\": \"4a59e316-54a6-4eff-87e5-8147cc58420f\",\n      \"skuCode\": \"EXAMPLE-STEAM-WW\",\n      \"quantity\": 12,\n      \"orderReference\": \"store-order-10432\",\n      \"pulledAt\": \"2026-11-02T09:30:00Z\",\n      \"salesCountryCode\": \"DE\",\n      \"detectedCountryCode\": \"off\",\n      \"countryMismatch\": true,\n      \"warnings\": [\n        \"COUNTRY_MISMATCH\"\n      ],\n      \"parentOrderReference\": \"store-order-10432\",\n      \"lineIndex\": 1\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/transactions?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/transactions?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "transactions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Return only transactions with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List transactions**\n\n**Deprecated name.** Use `GET /keys/pulls`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nKey pull history. Paginated. Filter by from/to (ISO 8601 date range) for analytics and reporting. When `meta.hasMore` is true, `meta.nextUrl` is the full URL for the next page (same filters; cursor updated).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/transactions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Orders",
      "description": "Order lifecycle: aggregate reads, create (single SKU), bulk create (multi-SKU cart), and pre-order cancel. **All mutating requests require `Idempotency-Key`.** Scope: `seller:orders:write` (legacy `seller:keys:pull` also accepted); `seller:orders:read` for reads only.",
      "item": [
        {
          "name": "GET — List orders, or look one up by reference or id",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders?orderReference=&orderReadableId=&filters=&from=&to=&status=preordered&cursor=&limit=50&parentOrderReference=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ],
              "query": [
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Your store order id (same value passed when creating the order, at most 255 characters there; a longer value matches no order). Mutually exclusive with orderReadableId.",
                  "disabled": true
                },
                {
                  "key": "orderReadableId",
                  "value": "",
                  "description": "Any order id (`ord_…`): `orderId` from any order response, or `orderReadableId` from a create response, a bulk line or `POST /keys/pull`. Mutually exclusive with orderReference.",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Listing mode: inclusive lower bound on `fulfilledAt` (ISO-8601). Used only when neither `orderReference` nor `orderReadableId` is given. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Listing mode: inclusive upper bound on `fulfilledAt` (ISO-8601). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "preordered",
                  "description": "Listing mode: filter by order status. The listing pages until it has `limit` matches or reaches the end of your orders; `meta.nextCursor` is null when nothing more matches. `preordered` selects the same orders as `awaiting_release` (its earlier name). **Values the listing can serve:** until durable order reads are switched on for an environment, its listing is built from delivered keys and holds `fulfilled`, `returned` and `refunded` orders only. Every other value needs the durable read model: without it the filter returns an empty page on contract dates before `2026-12-01`, and `422 VALIDATION_FAILED` on `2026-12-01` and later, where `details.issues[0]` names `status` and its `allowedValues` lists what can be served. Once durable reads are on, every value is served. enum: preordered, awaiting_release, awaiting_stock, ready, partially_fulfilled, fulfilled, cancelled, returned, refunded, failed",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Listing mode: opaque keyset cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Listing mode: page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "parentOrderReference",
                  "value": "",
                  "description": "Every line of one bulk cart, by the `parentOrderReference` you sent in its `integrationOrderContext`. Returns `data` as an array of order aggregates in line order (at most 100) and `meta.parentOrderReference`. Cannot be combined with `orderReference` or `orderReadableId`. Refunds stay per line: refund each line by its own `orderReference`.",
                  "disabled": true
                }
              ]
            },
            "description": "**List orders, or look one up by reference or id**\n\nOne operation, three modes, chosen by the query. **Look up one order:** `orderReference` (your store order id) or `orderReadableId` (any order id, `orderId` from any order response); `data` is one order aggregate, 404 when no order matches. To fetch by id you can also call `GET /orders/{orderId}`. **One bulk cart:** `parentOrderReference`; `data` is an array of aggregates. **List:** none of those; `data` is an array of order rows with a cursor (see Listing mode below), an empty page when nothing matches. Tell the modes apart by the query you sent, or by `data` being an object (lookup) or an array (cart, list). Reconcile key pulls and active pre-order reservations by **orderReference** (your store order id) or **orderReadableId** (`ord_…` from create-order responses). Provide exactly one. Requires `seller:orders:read`; `seller:orders:write` and the legacy `seller:products:read` and `seller:keys:pull` are also accepted. Does not return key plaintext. **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Listing mode:** when neither `orderReference` nor `orderReadableId` is given, the endpoint lists the seller's order tuples keyset-paginated over `(fulfilledAt, orderReference)` — `?from&to&status&cursor&limit`. Built for full-ledger reconciliation and disaster recovery: after a total store-DB loss, page from your launch date to now and rebuild the complete ledger. Responses never include key plaintext.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Order aggregate for the given orderReference or orderReadableId (fulfilled pulls + active pre-orders). No plaintext keys.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders?orderReference=&orderReadableId=&filters=&from=&to=&status=preordered&cursor=&limit=50&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders"
                  ],
                  "query": [
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Your store order id (same value passed when creating the order, at most 255 characters there; a longer value matches no order). Mutually exclusive with orderReadableId.",
                      "disabled": true
                    },
                    {
                      "key": "orderReadableId",
                      "value": "",
                      "description": "Any order id (`ord_…`): `orderId` from any order response, or `orderReadableId` from a create response, a bulk line or `POST /keys/pull`. Mutually exclusive with orderReference.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Listing mode: inclusive lower bound on `fulfilledAt` (ISO-8601). Used only when neither `orderReference` nor `orderReadableId` is given. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Listing mode: inclusive upper bound on `fulfilledAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "preordered",
                      "description": "Listing mode: filter by order status. The listing pages until it has `limit` matches or reaches the end of your orders; `meta.nextCursor` is null when nothing more matches. `preordered` selects the same orders as `awaiting_release` (its earlier name). **Values the listing can serve:** until durable order reads are switched on for an environment, its listing is built from delivered keys and holds `fulfilled`, `returned` and `refunded` orders only. Every other value needs the durable read model: without it the filter returns an empty page on contract dates before `2026-12-01`, and `422 VALIDATION_FAILED` on `2026-12-01` and later, where `details.issues[0]` names `status` and its `allowedValues` lists what can be served. Once durable reads are on, every value is served. enum: preordered, awaiting_release, awaiting_stock, ready, partially_fulfilled, fulfilled, cancelled, returned, refunded, failed",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Listing mode: opaque keyset cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Listing mode: page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Every line of one bulk cart, by the `parentOrderReference` you sent in its `integrationOrderContext`. Returns `data` as an array of order aggregates in line order (at most 100) and `meta.parentOrderReference`. Cannot be combined with `orderReference` or `orderReadableId`. Refunds stay per line: refund each line by its own `orderReference`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List orders, or look one up by reference or id**\n\nOne operation, three modes, chosen by the query. **Look up one order:** `orderReference` (your store order id) or `orderReadableId` (any order id, `orderId` from any order response); `data` is one order aggregate, 404 when no order matches. To fetch by id you can also call `GET /orders/{orderId}`. **One bulk cart:** `parentOrderReference`; `data` is an array of aggregates. **List:** none of those; `data` is an array of order rows with a cursor (see Listing mode below), an empty page when nothing matches. Tell the modes apart by the query you sent, or by `data` being an object (lookup) or an array (cart, list). Reconcile key pulls and active pre-order reservations by **orderReference** (your store order id) or **orderReadableId** (`ord_…` from create-order responses). Provide exactly one. Requires `seller:orders:read`; `seller:orders:write` and the legacy `seller:products:read` and `seller:keys:pull` are also accepted. Does not return key plaintext. **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Listing mode:** when neither `orderReference` nor `orderReadableId` is given, the endpoint lists the seller's order tuples keyset-paginated over `(fulfilledAt, orderReference)` — `?from&to&status&cursor&limit`. Built for full-ledger reconciliation and disaster recovery: after a total store-DB loss, page from your launch date to now and rebuild the complete ledger. Responses never include key plaintext.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"orderReference\": \"store-order-10432\",\n    \"status\": \"fulfilled\",\n    \"fulfilled\": [\n      {\n        \"skuCode\": \"SANDBOX-ALWAYS-001\",\n        \"allocationId\": \"00000000-0000-4000-8000-000000000001\",\n        \"fulfilledQuantity\": 1,\n        \"firstKeyPullId\": \"00000000-0000-4000-8000-0000000000aa\",\n        \"orderReadableId\": \"ord_abc12345\"\n      }\n    ],\n    \"preOrderActive\": [],\n    \"refunds\": [],\n    \"parentOrderReference\": null,\n    \"lineIndex\": null\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders?orderReference=&orderReadableId=&filters=&from=&to=&status=preordered&cursor=&limit=50&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders"
                  ],
                  "query": [
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Your store order id (same value passed when creating the order, at most 255 characters there; a longer value matches no order). Mutually exclusive with orderReadableId.",
                      "disabled": true
                    },
                    {
                      "key": "orderReadableId",
                      "value": "",
                      "description": "Any order id (`ord_…`): `orderId` from any order response, or `orderReadableId` from a create response, a bulk line or `POST /keys/pull`. Mutually exclusive with orderReference.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Listing mode: inclusive lower bound on `fulfilledAt` (ISO-8601). Used only when neither `orderReference` nor `orderReadableId` is given. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Listing mode: inclusive upper bound on `fulfilledAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "preordered",
                      "description": "Listing mode: filter by order status. The listing pages until it has `limit` matches or reaches the end of your orders; `meta.nextCursor` is null when nothing more matches. `preordered` selects the same orders as `awaiting_release` (its earlier name). **Values the listing can serve:** until durable order reads are switched on for an environment, its listing is built from delivered keys and holds `fulfilled`, `returned` and `refunded` orders only. Every other value needs the durable read model: without it the filter returns an empty page on contract dates before `2026-12-01`, and `422 VALIDATION_FAILED` on `2026-12-01` and later, where `details.issues[0]` names `status` and its `allowedValues` lists what can be served. Once durable reads are on, every value is served. enum: preordered, awaiting_release, awaiting_stock, ready, partially_fulfilled, fulfilled, cancelled, returned, refunded, failed",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Listing mode: opaque keyset cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Listing mode: page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Every line of one bulk cart, by the `parentOrderReference` you sent in its `integrationOrderContext`. Returns `data` as an array of order aggregates in line order (at most 100) and `meta.parentOrderReference`. Cannot be combined with `orderReference` or `orderReadableId`. Refunds stay per line: refund each line by its own `orderReference`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List orders, or look one up by reference or id**\n\nOne operation, three modes, chosen by the query. **Look up one order:** `orderReference` (your store order id) or `orderReadableId` (any order id, `orderId` from any order response); `data` is one order aggregate, 404 when no order matches. To fetch by id you can also call `GET /orders/{orderId}`. **One bulk cart:** `parentOrderReference`; `data` is an array of aggregates. **List:** none of those; `data` is an array of order rows with a cursor (see Listing mode below), an empty page when nothing matches. Tell the modes apart by the query you sent, or by `data` being an object (lookup) or an array (cart, list). Reconcile key pulls and active pre-order reservations by **orderReference** (your store order id) or **orderReadableId** (`ord_…` from create-order responses). Provide exactly one. Requires `seller:orders:read`; `seller:orders:write` and the legacy `seller:products:read` and `seller:keys:pull` are also accepted. Does not return key plaintext. **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Listing mode:** when neither `orderReference` nor `orderReadableId` is given, the endpoint lists the seller's order tuples keyset-paginated over `(fulfilledAt, orderReference)` — `?from&to&status&cursor&limit`. Built for full-ledger reconciliation and disaster recovery: after a total store-DB loss, page from your launch date to now and rebuild the complete ledger. Responses never include key plaintext.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Create order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders"
              ]
            },
            "description": "**Create order**\n\nCreate order and pull keys (or reserve for pre-order). Provide **skuId or skuCode** with **quantity** as a JSON **integer** (1–1000). **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries; replays require the **same canonical JSON body** (sorted keys, SHA-256 — see https://docs.avrix.io/seller-api/integration-recipes); mismatch returns **409** `IDEMPOTENCY_KEY_MISMATCH` with **`details.requestBodyHash`**. API catalog orders require **integrationOrderContext** with `salesTaxRatePercent`, `salesPriceGrossMinor`, and `salesCountryCode` (422 `TAX_DECLARATION_REQUIRED` / `SALES_COUNTRY_REQUIRED` if omitted). Other context fields are declared retail evidence and do not replace wholesale settlement. Optional **metadata** — see https://docs.avrix.io/seller-api/integration-recipes. **Pre-order**: If the product has a future release date, keys are reserved (not delivered) and the response `type` is `pre-order`. When the deployment requires integration order context, responses include **`X-Seller-Api-Strict-Integration-Context: true`**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, `KYB_NOT_VERIFIED`, `TREASURY_CAPABILITY_MISSING`, preorder / fulfilment denials |\n| CAT_* | Visibility / BMA denials, unknown SKU or product for company |\n| KEY_* | `NO_AVAILABLE_KEYS` when immediate fulfilment cannot allocate |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"NL\",\n  \"expectedUnitPriceCents\": 5999,\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 4958,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1041,\n    \"salesTaxRatePercent\": 21,\n    \"consumerIp\": \"8.8.8.8\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"psp_txn_10432\",\n    \"checkoutSessionId\": \"cs_store_10432\",\n    \"salesChannel\": \"web\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Order created (fulfilled or pre-order). **Discriminate on `data.type`.**",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders"
                  ]
                },
                "description": "**Create order**\n\nCreate order and pull keys (or reserve for pre-order). Provide **skuId or skuCode** with **quantity** as a JSON **integer** (1–1000). **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries; replays require the **same canonical JSON body** (sorted keys, SHA-256 — see https://docs.avrix.io/seller-api/integration-recipes); mismatch returns **409** `IDEMPOTENCY_KEY_MISMATCH` with **`details.requestBodyHash`**. API catalog orders require **integrationOrderContext** with `salesTaxRatePercent`, `salesPriceGrossMinor`, and `salesCountryCode` (422 `TAX_DECLARATION_REQUIRED` / `SALES_COUNTRY_REQUIRED` if omitted). Other context fields are declared retail evidence and do not replace wholesale settlement. Optional **metadata** — see https://docs.avrix.io/seller-api/integration-recipes. **Pre-order**: If the product has a future release date, keys are reserved (not delivered) and the response `type` is `pre-order`. When the deployment requires integration order context, responses include **`X-Seller-Api-Strict-Integration-Context: true`**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, `KYB_NOT_VERIFIED`, `TREASURY_CAPABILITY_MISSING`, preorder / fulfilment denials |\n| CAT_* | Visibility / BMA denials, unknown SKU or product for company |\n| KEY_* | `NO_AVAILABLE_KEYS` when immediate fulfilment cannot allocate |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"NL\",\n  \"expectedUnitPriceCents\": 5999,\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 4958,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1041,\n    \"salesTaxRatePercent\": 21,\n    \"consumerIp\": \"8.8.8.8\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"psp_txn_10432\",\n    \"checkoutSessionId\": \"cs_store_10432\",\n    \"salesChannel\": \"web\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"fulfilled\",\n    \"skuId\": \"00000000-0000-4000-8000-000000000002\",\n    \"skuCode\": \"SANDBOX-ALWAYS-001\",\n    \"orderReference\": \"store-order-10432\",\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"keyIds\": [\n      \"00000000-0000-4000-8000-0000000000bb\"\n    ],\n    \"pulled\": 1,\n    \"allocationId\": \"00000000-0000-4000-8000-000000000001\",\n    \"orderReadableId\": \"ord_abc12345\",\n    \"fulfilledAt\": \"2026-08-07T12:00:00.000Z\"\n  },\n  \"contractTermId\": \"00000000-0000-4000-8000-000000000099\",\n  \"contractTermVersion\": 1\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders"
                  ]
                },
                "description": "**Create order**\n\nCreate order and pull keys (or reserve for pre-order). Provide **skuId or skuCode** with **quantity** as a JSON **integer** (1–1000). **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries; replays require the **same canonical JSON body** (sorted keys, SHA-256 — see https://docs.avrix.io/seller-api/integration-recipes); mismatch returns **409** `IDEMPOTENCY_KEY_MISMATCH` with **`details.requestBodyHash`**. API catalog orders require **integrationOrderContext** with `salesTaxRatePercent`, `salesPriceGrossMinor`, and `salesCountryCode` (422 `TAX_DECLARATION_REQUIRED` / `SALES_COUNTRY_REQUIRED` if omitted). Other context fields are declared retail evidence and do not replace wholesale settlement. Optional **metadata** — see https://docs.avrix.io/seller-api/integration-recipes. **Pre-order**: If the product has a future release date, keys are reserved (not delivered) and the response `type` is `pre-order`. When the deployment requires integration order context, responses include **`X-Seller-Api-Strict-Integration-Context: true`**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, `KYB_NOT_VERIFIED`, `TREASURY_CAPABILITY_MISSING`, preorder / fulfilment denials |\n| CAT_* | Visibility / BMA denials, unknown SKU or product for company |\n| KEY_* | `NO_AVAILABLE_KEYS` when immediate fulfilment cannot allocate |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"NL\",\n  \"expectedUnitPriceCents\": 5999,\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 5999,\n    \"salesPriceNetMinor\": 4958,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1041,\n    \"salesTaxRatePercent\": 21,\n    \"consumerIp\": \"8.8.8.8\",\n    \"paymentMethodFamily\": \"card\",\n    \"paymentProcessorReference\": \"psp_txn_10432\",\n    \"checkoutSessionId\": \"cs_store_10432\",\n    \"salesChannel\": \"web\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Reserve hot-drop inventory (short-TTL hold)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/reserve",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "reserve"
              ]
            },
            "description": "**Reserve hot-drop inventory (short-TTL hold)**\n\nReserve `quantity` slots against a **hot-drop** allocation without yet consuming any keys. Intended for high-contention launches where stores need to lock availability for a buyer in-flight and then finalise the purchase with `POST /orders/commit` before the reservation expires.\n\nThe reservation expires after a short TTL (a handful of seconds). If the client does not call `/orders/commit` in time, the slot is released automatically and becomes available to other buyers.\n\nSpecify the allocation by `allocationId` or resolve it from `skuId` / `skuCode`. The route is a **no-op for allocations that are not in hot-drop mode** — in that case use `POST /orders` instead; this endpoint returns **412 HOT_DROP_NOT_ENABLED** so clients can fall back automatically. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, reservation conflicts, TTL / capacity denials (`reserveError` details) |\n| CAT_* | `HOT_DROP_UNAVAILABLE`, not eligible SKU |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The reservation runs the same order admission as `POST /orders`, `POST /orders/preview` and `POST /orders/hold` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required, there is no default country; `expectedUnitPriceCents` or `expectedWholesaleUnitPriceCents` is compared when sent; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a slot is never reserved for a sale commit refuses for a reason you control. The slot binds the admitted price and currency, which is what `POST /orders/commit` compares against. Error codes (422 unless noted, `details.reserveError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH (409), INVALID_CATALOG_PRICE, EXPECTED_PRICE_CONFLICT, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE (503), CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE (503). See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reserve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"US\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Reservation created; call `POST /orders/commit` with `reservationId` before `expiresAt`.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reserve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reserve"
                  ]
                },
                "description": "**Reserve hot-drop inventory (short-TTL hold)**\n\nReserve `quantity` slots against a **hot-drop** allocation without yet consuming any keys. Intended for high-contention launches where stores need to lock availability for a buyer in-flight and then finalise the purchase with `POST /orders/commit` before the reservation expires.\n\nThe reservation expires after a short TTL (a handful of seconds). If the client does not call `/orders/commit` in time, the slot is released automatically and becomes available to other buyers.\n\nSpecify the allocation by `allocationId` or resolve it from `skuId` / `skuCode`. The route is a **no-op for allocations that are not in hot-drop mode** — in that case use `POST /orders` instead; this endpoint returns **412 HOT_DROP_NOT_ENABLED** so clients can fall back automatically. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, reservation conflicts, TTL / capacity denials (`reserveError` details) |\n| CAT_* | `HOT_DROP_UNAVAILABLE`, not eligible SKU |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The reservation runs the same order admission as `POST /orders`, `POST /orders/preview` and `POST /orders/hold` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required, there is no default country; `expectedUnitPriceCents` or `expectedWholesaleUnitPriceCents` is compared when sent; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a slot is never reserved for a sale commit refuses for a reason you control. The slot binds the admitted price and currency, which is what `POST /orders/commit` compares against. Error codes (422 unless noted, `details.reserveError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH (409), INVALID_CATALOG_PRICE, EXPECTED_PRICE_CONFLICT, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE (503), CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE (503). See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reserve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"reservation\",\n    \"reservationId\": \"35e95216-ec11-476d-87ae-ff21f19db6a2\",\n    \"allocationId\": \"8115d79d-d9e6-42d4-8af3-45a2af7ae8c5\",\n    \"quantity\": 12,\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"expiresInSeconds\": 300,\n    \"remainingSlots\": 12,\n    \"orderReference\": \"store-order-10432\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reserve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reserve"
                  ]
                },
                "description": "**Reserve hot-drop inventory (short-TTL hold)**\n\nReserve `quantity` slots against a **hot-drop** allocation without yet consuming any keys. Intended for high-contention launches where stores need to lock availability for a buyer in-flight and then finalise the purchase with `POST /orders/commit` before the reservation expires.\n\nThe reservation expires after a short TTL (a handful of seconds). If the client does not call `/orders/commit` in time, the slot is released automatically and becomes available to other buyers.\n\nSpecify the allocation by `allocationId` or resolve it from `skuId` / `skuCode`. The route is a **no-op for allocations that are not in hot-drop mode** — in that case use `POST /orders` instead; this endpoint returns **412 HOT_DROP_NOT_ENABLED** so clients can fall back automatically. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, reservation conflicts, TTL / capacity denials (`reserveError` details) |\n| CAT_* | `HOT_DROP_UNAVAILABLE`, not eligible SKU |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The reservation runs the same order admission as `POST /orders`, `POST /orders/preview` and `POST /orders/hold` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required, there is no default country; `expectedUnitPriceCents` or `expectedWholesaleUnitPriceCents` is compared when sent; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a slot is never reserved for a sale commit refuses for a reason you control. The slot binds the admitted price and currency, which is what `POST /orders/commit` compares against. Error codes (422 unless noted, `details.reserveError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH (409), INVALID_CATALOG_PRICE, EXPECTED_PRICE_CONFLICT, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE (503), CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE (503). See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reserve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\",\n  \"countryCode\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Commit a hot-drop reservation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/commit",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "commit"
              ]
            },
            "description": "**Commit a hot-drop reservation**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/commit`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nFinalise a reservation previously returned by `POST /orders/reserve`. Runs the full contract chain (gating, pricing, pre-order flags) and either returns real keys (`fulfillmentType: fulfilled`) or records the pre-order (`fulfillmentType: pre-order`). On any downstream failure the reservation is **released** back into the available pool automatically.\n\nThe reservation is bounded by the TTL returned from `/orders/reserve`. Commits for expired reservations fail with **410 RESERVATION_GONE** — in that case the client should re-reserve. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, stale reservation, insufficient inventory at commit, `pullError` allocations |\n| CAT_* | Hot-drop / visibility denials |\n| KEY_* | Pull-path shortages surfaced with SKU/allocation hints |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reservationId\": \"0b9f4c1e-6a57-4d1c-9a55-2f1f0c3d7e42\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Reservation committed. Shape depends on `type`: `fulfilled` returns real keys, `pre-order` returns reserved counts with release window.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/commit",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "commit"
                  ]
                },
                "description": "**Commit a hot-drop reservation**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/commit`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nFinalise a reservation previously returned by `POST /orders/reserve`. Runs the full contract chain (gating, pricing, pre-order flags) and either returns real keys (`fulfillmentType: fulfilled`) or records the pre-order (`fulfillmentType: pre-order`). On any downstream failure the reservation is **released** back into the available pool automatically.\n\nThe reservation is bounded by the TTL returned from `/orders/reserve`. Commits for expired reservations fail with **410 RESERVATION_GONE** — in that case the client should re-reserve. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, stale reservation, insufficient inventory at commit, `pullError` allocations |\n| CAT_* | Hot-drop / visibility denials |\n| KEY_* | Pull-path shortages surfaced with SKU/allocation hints |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"reservationId\": \"0b9f4c1e-6a57-4d1c-9a55-2f1f0c3d7e42\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"fulfilled\",\n    \"allocationId\": \"86ee5c36-8025-4d10-808b-15e23b6687f6\",\n    \"orderReference\": \"store-order-10432\",\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"keyIds\": [\n      \"09f897e2-04b4-4ccf-851a-a44e9a6cc294\"\n    ],\n    \"pulled\": 12,\n    \"fulfilledAt\": \"2026-11-02T09:30:00Z\",\n    \"orderId\": \"ord_a9s7uz9y\",\n    \"warnings\": [\n      \"example_warning\"\n    ]\n  },\n  \"contractTermId\": \"84292b34-365e-4177-8c5c-ef13ee9a9229\",\n  \"contractTermVersion\": 1\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/commit",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "commit"
                  ]
                },
                "description": "**Commit a hot-drop reservation**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/commit`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nFinalise a reservation previously returned by `POST /orders/reserve`. Runs the full contract chain (gating, pricing, pre-order flags) and either returns real keys (`fulfillmentType: fulfilled`) or records the pre-order (`fulfillmentType: pre-order`). On any downstream failure the reservation is **released** back into the available pool automatically.\n\nThe reservation is bounded by the TTL returned from `/orders/reserve`. Commits for expired reservations fail with **410 RESERVATION_GONE** — in that case the client should re-reserve. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, stale reservation, insufficient inventory at commit, `pullError` allocations |\n| CAT_* | Hot-drop / visibility denials |\n| KEY_* | Pull-path shortages surfaced with SKU/allocation hints |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"reservationId\": \"0b9f4c1e-6a57-4d1c-9a55-2f1f0c3d7e42\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Commit a hot-drop reservation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/commit",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "reservations",
                ":reservationId",
                "commit"
              ],
              "variable": [
                {
                  "key": "reservationId",
                  "value": "{{reservationId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Commit a hot-drop reservation**\n\nTurn a hot-drop reservation into an order; the reservation is named in the path. The body carries the same optional fields as `POST /orders/commit` (`metadata`, `integrationOrderContext`, `consumerGeoAttestId`), and `reservationId` may be left out. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\nThe same handler, idempotency and responses as `POST /orders/commit`, which takes `reservationId` in the body and is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Reservation committed. Shape depends on `type`: `fulfilled` returns real keys, `pre-order` returns reserved counts with release window.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/commit",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reservations",
                    ":reservationId",
                    "commit"
                  ],
                  "variable": [
                    {
                      "key": "reservationId",
                      "value": "{{reservationId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Commit a hot-drop reservation**\n\nTurn a hot-drop reservation into an order; the reservation is named in the path. The body carries the same optional fields as `POST /orders/commit` (`metadata`, `integrationOrderContext`, `consumerGeoAttestId`), and `reservationId` may be left out. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\nThe same handler, idempotency and responses as `POST /orders/commit`, which takes `reservationId` in the body and is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"fulfilled\",\n    \"allocationId\": \"69f4bd3e-20e1-414b-806c-01ec0ce8ed1a\",\n    \"orderReference\": \"store-order-10432\",\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"keyIds\": [\n      \"b6d7b421-88a8-4b50-8c06-cfed92b28978\"\n    ],\n    \"pulled\": 12,\n    \"fulfilledAt\": \"2026-11-02T09:30:00Z\",\n    \"orderId\": \"ord_cysr5dde\",\n    \"warnings\": [\n      \"example_warning\"\n    ]\n  },\n  \"contractTermId\": \"5d36b545-f7f9-4885-8668-00b4cf2d9723\",\n  \"contractTermVersion\": 1\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/commit",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reservations",
                    ":reservationId",
                    "commit"
                  ],
                  "variable": [
                    {
                      "key": "reservationId",
                      "value": "{{reservationId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Commit a hot-drop reservation**\n\nTurn a hot-drop reservation into an order; the reservation is named in the path. The body carries the same optional fields as `POST /orders/commit` (`metadata`, `integrationOrderContext`, `consumerGeoAttestId`), and `reservationId` may be left out. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\nThe same handler, idempotency and responses as `POST /orders/commit`, which takes `reservationId` in the body and is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 410, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/commit`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"reservationId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Preview order (price + fulfillment estimate)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "preview"
              ]
            },
            "description": "**Preview order (price + fulfillment estimate)**\n\n**Scopes:** `seller:orders:preview`, `seller:orders:write` or the legacy `seller:keys:pull`. Non-binding estimate; debits the **`orders`** rate-limit class.\n\nRead-only preview of what `POST /orders` would do. Returns the wholesale unit price from the seller's allocation, the per-line and total cost, and the expected fulfillment type (`fulfilled` for ready-to-deliver keys or `pre-order` for unreleased SKUs). Does **not** acquire any inventory locks, does **not** record a transaction, and does **not** charge against pre-order capacity. Stores call this from their checkout summary to display the final cost to the buyer; the binding price is the one that comes back from `POST /orders`. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, estimate denied, pricing headroom errors surfaced as `previewError` details |\n| CAT_* | Product/SKU not visible under BMA |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Price binding:** every priced preview returns `priceCommitment: { token, expiresAt }` (hard TTL 15 minutes) — a capability-independent way to commit the previewed price on POST /orders. Production deployments fail closed at boot when price signing is unconfigured, so in production the field is always present on priced previews. In sandbox/local environments presence is signalled by `whoami.capabilities.priceCommitmentConfigured`; when `false` the field is omitted — send `expectedUnitPriceCents` on commit instead. Expired tokens fail with **`PRICE_COMMITMENT_EXPIRED`** (re-preview).\n\n**Scopes (any one of):** `seller:orders:preview`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"NL\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 7999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1388,\n    \"salesTaxRatePercent\": 21,\n    \"salesChannel\": \"web\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Preview successful",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "preview"
                  ]
                },
                "description": "**Preview order (price + fulfillment estimate)**\n\n**Scopes:** `seller:orders:preview`, `seller:orders:write` or the legacy `seller:keys:pull`. Non-binding estimate; debits the **`orders`** rate-limit class.\n\nRead-only preview of what `POST /orders` would do. Returns the wholesale unit price from the seller's allocation, the per-line and total cost, and the expected fulfillment type (`fulfilled` for ready-to-deliver keys or `pre-order` for unreleased SKUs). Does **not** acquire any inventory locks, does **not** record a transaction, and does **not** charge against pre-order capacity. Stores call this from their checkout summary to display the final cost to the buyer; the binding price is the one that comes back from `POST /orders`. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, estimate denied, pricing headroom errors surfaced as `previewError` details |\n| CAT_* | Product/SKU not visible under BMA |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Price binding:** every priced preview returns `priceCommitment: { token, expiresAt }` (hard TTL 15 minutes) — a capability-independent way to commit the previewed price on POST /orders. Production deployments fail closed at boot when price signing is unconfigured, so in production the field is always present on priced previews. In sandbox/local environments presence is signalled by `whoami.capabilities.priceCommitmentConfigured`; when `false` the field is omitted — send `expectedUnitPriceCents` on commit instead. Expired tokens fail with **`PRICE_COMMITMENT_EXPIRED`** (re-preview).\n\n**Scopes (any one of):** `seller:orders:preview`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"NL\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 7999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1388,\n    \"salesTaxRatePercent\": 21,\n    \"salesChannel\": \"web\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"order_preview\",\n    \"fulfillmentType\": \"fulfilled\",\n    \"allocationId\": \"00000000-0000-4000-8000-000000000001\",\n    \"allocationRemaining\": 942,\n    \"inventoryAvailable\": 942,\n    \"partialFulfillmentExpected\": false,\n    \"maxFulfillableQuantity\": 942,\n    \"canFulfill\": true,\n    \"lines\": [\n      {\n        \"skuId\": \"00000000-0000-4000-8000-000000000002\",\n        \"skuCode\": \"SANDBOX-ALWAYS-001\",\n        \"quantity\": 1,\n        \"unitPriceCents\": 999,\n        \"unitPriceMinor\": 999,\n        \"lineTotalCents\": 999,\n        \"lineTotalMinor\": 999,\n        \"currencyCode\": \"USD\",\n        \"currencyExponent\": 2,\n        \"initialUnitPriceCents\": 999,\n        \"initialUnitPriceMinor\": 999,\n        \"promo\": null,\n        \"promoResolution\": \"none\",\n        \"listPromo\": null,\n        \"advertisedUnitPriceCents\": 999,\n        \"advertisedUnitPriceMinor\": 999\n      }\n    ],\n    \"totalCents\": 999,\n    \"totalMinor\": 999,\n    \"currencyCode\": \"USD\",\n    \"currencyExponent\": 2,\n    \"estimateOnly\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`) and `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`) make this call fail before any work is done. `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`). On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally, and only `rate_limit` is honoured, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/preview",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "preview"
                  ]
                },
                "description": "**Preview order (price + fulfillment estimate)**\n\n**Scopes:** `seller:orders:preview`, `seller:orders:write` or the legacy `seller:keys:pull`. Non-binding estimate; debits the **`orders`** rate-limit class.\n\nRead-only preview of what `POST /orders` would do. Returns the wholesale unit price from the seller's allocation, the per-line and total cost, and the expected fulfillment type (`fulfilled` for ready-to-deliver keys or `pre-order` for unreleased SKUs). Does **not** acquire any inventory locks, does **not** record a transaction, and does **not** charge against pre-order capacity. Stores call this from their checkout summary to display the final cost to the buyer; the binding price is the one that comes back from `POST /orders`. Counts against the **`orders` rate-limit class**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED`, estimate denied, pricing headroom errors surfaced as `previewError` details |\n| CAT_* | Product/SKU not visible under BMA |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Pre-orders (capability `preorder`):** purchasing `launchPhase: pre_order` products requires `whoami.capabilities.preorderEnabled: true` (default **true**; a Content Owner can opt its products out). Without it, pre-order-phase SKUs fail with **`PRODUCT_NOT_SELLABLE`** (`recoverable: false`) — check the capability up front instead of retrying.\n\n**Price binding:** every priced preview returns `priceCommitment: { token, expiresAt }` (hard TTL 15 minutes) — a capability-independent way to commit the previewed price on POST /orders. Production deployments fail closed at boot when price signing is unconfigured, so in production the field is always present on priced previews. In sandbox/local environments presence is signalled by `whoami.capabilities.priceCommitmentConfigured`; when `false` the field is omitted — send `expectedUnitPriceCents` on commit instead. Expired tokens fail with **`PRICE_COMMITMENT_EXPIRED`** (re-preview).\n\n**Scopes (any one of):** `seller:orders:preview`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"NL\",\n  \"integrationOrderContext\": {\n    \"schemaVersion\": 1,\n    \"salesCountryCode\": \"NL\",\n    \"currencyCode\": \"EUR\",\n    \"salesPriceGrossMinor\": 7999,\n    \"priceIncludesTax\": true,\n    \"salesTaxAmountMinor\": 1388,\n    \"salesTaxRatePercent\": 21,\n    \"salesChannel\": \"web\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Create checkout soft-hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "hold"
              ]
            },
            "description": "**Create checkout soft-hold**\n\nOptional short-lived checkout slot hold between preview and `POST /orders` (when enabled on the deployment — see `whoami.capabilities.checkoutHoldEnabled`). Authority remains `POST /orders`. Returns **412** `CHECKOUT_HOLD_DISABLED` when off. See `https://docs.avrix.io/seller-api/order-preview`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The hold runs the same order admission as `POST /orders` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a hold is never granted for a sale commit refuses for a reason you control. Error codes (422, `details.holdError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"US\",\n  \"orderReference\": \"store-order-10432\",\n  \"expectedUnitPriceCents\": 5999\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Hold created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold"
                  ]
                },
                "description": "**Create checkout soft-hold**\n\nOptional short-lived checkout slot hold between preview and `POST /orders` (when enabled on the deployment — see `whoami.capabilities.checkoutHoldEnabled`). Authority remains `POST /orders`. Returns **412** `CHECKOUT_HOLD_DISABLED` when off. See `https://docs.avrix.io/seller-api/order-preview`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The hold runs the same order admission as `POST /orders` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a hold is never granted for a sale commit refuses for a reason you control. Error codes (422, `details.holdError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"US\",\n  \"orderReference\": \"store-order-10432\",\n  \"expectedUnitPriceCents\": 5999\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"checkout_hold\",\n    \"holdId\": \"dc478e35-1633-4ff9-87a8-718d6088ca50\",\n    \"checkoutHoldId\": \"1bdd043f-e0f8-45cb-8910-25d12932469a\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"expiresInSeconds\": 300,\n    \"allocationId\": \"4e29935c-6045-48a9-8190-efaacca47148\",\n    \"maxFulfillableQuantity\": 12,\n    \"commitRequirements\": {\n      \"missing\": [\n        \"example_missing\"\n      ]\n    },\n    \"unitPriceCents\": 2450,\n    \"initialUnitPriceCents\": 2450,\n    \"promo\": {\n      \"sourceType\": \"event\",\n      \"sourceId\": \"b103e708-ee3b-4e3e-86ab-a931b42bf0a7\",\n      \"discountPercent\": 20,\n      \"priceEffect\": \"settlement_price\",\n      \"startDate\": \"2026-11-02T09:30:00Z\",\n      \"endDate\": \"2026-11-02T09:30:00Z\"\n    },\n    \"promoResolution\": \"applied\",\n    \"listPromo\": {\n      \"sourceType\": \"event\",\n      \"sourceId\": \"b8839dd7-8f06-47a6-82d9-1d6a44568ad8\",\n      \"discountPercent\": 20,\n      \"priceEffect\": \"list_price\",\n      \"startDate\": \"2026-11-02T09:30:00Z\",\n      \"endDate\": \"2026-11-02T09:30:00Z\"\n    },\n    \"advertisedUnitPriceCents\": 2450,\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"salesCountryCode\": \"DE\",\n    \"priceBoundAt\": \"2026-11-02T09:30:00Z\",\n    \"skuId\": \"dbe11a56-fa39-40c4-821a-9bbdafd51362\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"quantity\": 12,\n    \"orderReference\": \"store-order-10432\",\n    \"remainingSlots\": 12\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold"
                  ]
                },
                "description": "**Create checkout soft-hold**\n\nOptional short-lived checkout slot hold between preview and `POST /orders` (when enabled on the deployment — see `whoami.capabilities.checkoutHoldEnabled`). Authority remains `POST /orders`. Returns **412** `CHECKOUT_HOLD_DISABLED` when off. See `https://docs.avrix.io/seller-api/order-preview`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP validation. Geo/VPN cross-check runs when `whoami.capabilities.consumerGeoEnforcementEnabled` is true. The hold runs the same order admission as `POST /orders` on the declaration you send (`countryCode` or `integrationOrderContext.salesCountryCode` is required; a declared `currencyCode` and `salesChannel` are checked against your footprint and the agreement), so a hold is never granted for a sale commit refuses for a reason you control. Error codes (422, `details.holdError`): SALES_COUNTRY_REQUIRED, CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_NOT_GRANTED, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, COUNTRY_RESTRICTED, REGION_LOCKED_FOR_SKU, REGION_LOCKED_FOR_CONTRACT, FOOTPRINT_COUNTRY_NOT_DECLARED, FOOTPRINT_CURRENCY_NOT_DECLARED, CURRENCY_NOT_PRICED_FOR_COUNTRY, CURRENCY_NOT_PERMITTED_BY_TERM, SALES_CHANNEL_NOT_PERMITTED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/creating-orders`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 412, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"countryCode\": \"US\",\n  \"orderReference\": \"store-order-10432\",\n  \"expectedUnitPriceCents\": 5999\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "DELETE — Release checkout soft-hold",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "hold"
              ]
            },
            "description": "**Release checkout soft-hold**\n\n**Deprecated name.** Use `DELETE /orders/hold/{holdId}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nRelease a checkout hold early. Requires `Idempotency-Key`. Scope: `seller:orders:write` or the legacy `seller:keys:pull`. Capability: `whoami.capabilities.checkoutHoldEnabled`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"holdId\": \"5f0c1b7e-2d94-4c1a-8f3e-9b6a4d2c7e10\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Release acknowledged. `data.released` is true when this call freed the hold, false when it was already released, consumed or expired — the cart is free either way and the call is safe to retry (never 404).",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold"
                  ]
                },
                "description": "**Release checkout soft-hold**\n\n**Deprecated name.** Use `DELETE /orders/hold/{holdId}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nRelease a checkout hold early. Requires `Idempotency-Key`. Scope: `seller:orders:write` or the legacy `seller:keys:pull`. Capability: `whoami.capabilities.checkoutHoldEnabled`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"holdId\": \"5f0c1b7e-2d94-4c1a-8f3e-9b6a4d2c7e10\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold"
                  ]
                },
                "description": "**Release checkout soft-hold**\n\n**Deprecated name.** Use `DELETE /orders/hold/{holdId}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nRelease a checkout hold early. Requires `Idempotency-Key`. Scope: `seller:orders:write` or the legacy `seller:keys:pull`. Capability: `whoami.capabilities.checkoutHoldEnabled`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"holdId\": \"5f0c1b7e-2d94-4c1a-8f3e-9b6a4d2c7e10\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Get a checkout hold",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "hold",
                ":holdId"
              ],
              "variable": [
                {
                  "key": "holdId",
                  "value": "{{holdId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get a checkout hold**\n\nRead a checkout hold created with the same API key: what it holds, until when, and the price it bound. 404 `HOLD_NOT_FOUND` once it is no longer live; `details.holdState` is `released` or `consumed` when the hold store still remembers (24 hours), else `not_found` (expired, never existed, or created with another key). To recover a lost `holdId`, replay `POST /orders/hold` with its original `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 412, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The live hold",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold",
                    ":holdId"
                  ],
                  "variable": [
                    {
                      "key": "holdId",
                      "value": "{{holdId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a checkout hold**\n\nRead a checkout hold created with the same API key: what it holds, until when, and the price it bound. 404 `HOLD_NOT_FOUND` once it is no longer live; `details.holdState` is `released` or `consumed` when the hold store still remembers (24 hours), else `not_found` (expired, never existed, or created with another key). To recover a lost `holdId`, replay `POST /orders/hold` with its original `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 412, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"checkout_hold\",\n    \"holdId\": \"3478c902-b0b1-47ef-8c88-1c909cf993df\",\n    \"checkoutHoldId\": \"e3e957ab-c932-473d-8a7e-ee53cccbdc8e\",\n    \"state\": \"active\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"expiresInSeconds\": 300,\n    \"allocationId\": \"87a9d04d-e98a-4e01-8402-ca5cf8f3643f\",\n    \"skuId\": \"e0e8c379-2d05-40a7-8bc6-aae350819aa5\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"quantity\": 12,\n    \"orderReference\": \"store-order-10432\",\n    \"customerReference\": \"example_customerreference\",\n    \"unitPriceMinor\": 2450,\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"salesCountryCode\": \"DE\",\n    \"priceBoundAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold",
                    ":holdId"
                  ],
                  "variable": [
                    {
                      "key": "holdId",
                      "value": "{{holdId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a checkout hold**\n\nRead a checkout hold created with the same API key: what it holds, until when, and the price it bound. 404 `HOLD_NOT_FOUND` once it is no longer live; `details.holdState` is `released` or `consumed` when the hold store still remembers (24 hours), else `not_found` (expired, never existed, or created with another key). To recover a lost `holdId`, replay `POST /orders/hold` with its original `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 412, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"holdId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "DELETE — Release a checkout hold",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "hold",
                ":holdId"
              ],
              "variable": [
                {
                  "key": "holdId",
                  "value": "{{holdId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Release a checkout hold**\n\nRelease a checkout hold before it expires; the hold is named in the path and no body is needed. Releasing is idempotent: a hold that is already released, consumed or expired answers 200 with `released: false`.\n\nThe same handler as `DELETE /orders/hold`, which takes `{ \"holdId\" }` in a JSON body and is the deprecated name of this operation. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Release acknowledged. `data.released` is true when this call freed the hold, false when it was already released, consumed or expired — the cart is free either way and the call is safe to retry (never 404).",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold",
                    ":holdId"
                  ],
                  "variable": [
                    {
                      "key": "holdId",
                      "value": "{{holdId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Release a checkout hold**\n\nRelease a checkout hold before it expires; the hold is named in the path and no body is needed. Releasing is idempotent: a hold that is already released, consumed or expired answers 200 with `released: false`.\n\nThe same handler as `DELETE /orders/hold`, which takes `{ \"holdId\" }` in a JSON body and is the deprecated name of this operation. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/hold/:holdId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "hold",
                    ":holdId"
                  ],
                  "variable": [
                    {
                      "key": "holdId",
                      "value": "{{holdId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Release a checkout hold**\n\nRelease a checkout hold before it expires; the hold is named in the path and no body is needed. Releasing is idempotent: a hold that is already released, consumed or expired answers 200 with `released: false`.\n\nThe same handler as `DELETE /orders/hold`, which takes `{ \"holdId\" }` in a JSON body and is the deprecated name of this operation. A body that also sends the id must send the same one: a different value is refused with 422 `VALIDATION_FAILED` naming the field.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `DELETE /api/seller/v1/orders/hold/{holdId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"holdId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Recover the keys already sold under an orderReference",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/recover-keys",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "recover-keys"
              ]
            },
            "description": "**Recover the keys already sold under an orderReference**\n\n**Scope:** `seller:orders:write` or the legacy `seller:keys:pull`. Debits the **`orders`** rate-limit class.\n\nRe-reads the keys that were already fulfilled for an `orderReference` — for the case where your store lost the `POST /orders` response (a crash between the pull and your own database write). Returns only keys that are still live for that reference (`revealed` / `assigned` / `redeemed`, the same filter the orderReference replay uses); returned or refunded keys are excluded. **Never pulls new inventory** and never creates a sale. Every call is audited as a key reveal.\n\nThis is the only read of key plaintext outside `POST /orders` / pull / export: `GET /orders` keeps never returning plaintext (certification case 16).\n\n**Route error codes:** `NOT_FOUND` (no live keys under the reference), `VALIDATION_FAILED`, `UNAUTHORIZED`, `FORBIDDEN`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`. See `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/recover-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Live keys for the reference",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/recover-keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "recover-keys"
                  ]
                },
                "description": "**Recover the keys already sold under an orderReference**\n\n**Scope:** `seller:orders:write` or the legacy `seller:keys:pull`. Debits the **`orders`** rate-limit class.\n\nRe-reads the keys that were already fulfilled for an `orderReference` — for the case where your store lost the `POST /orders` response (a crash between the pull and your own database write). Returns only keys that are still live for that reference (`revealed` / `assigned` / `redeemed`, the same filter the orderReference replay uses); returned or refunded keys are excluded. **Never pulls new inventory** and never creates a sale. Every call is audited as a key reveal.\n\nThis is the only read of key plaintext outside `POST /orders` / pull / export: `GET /orders` keeps never returning plaintext (certification case 16).\n\n**Route error codes:** `NOT_FOUND` (no live keys under the reference), `VALIDATION_FAILED`, `UNAUTHORIZED`, `FORBIDDEN`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`. See `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/recover-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"orderReference\": \"store-order-10432\",\n    \"recovered\": 1,\n    \"keyIds\": [\n      \"00000000-0000-4000-8000-0000000000aa\"\n    ],\n    \"keys\": [\n      \"AAAAA-BBBBB-CCCCC\"\n    ],\n    \"skuIds\": [\n      \"00000000-0000-4000-8000-0000000000bb\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/recover-keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "recover-keys"
                  ]
                },
                "description": "**Recover the keys already sold under an orderReference**\n\n**Scope:** `seller:orders:write` or the legacy `seller:keys:pull`. Debits the **`orders`** rate-limit class.\n\nRe-reads the keys that were already fulfilled for an `orderReference` — for the case where your store lost the `POST /orders` response (a crash between the pull and your own database write). Returns only keys that are still live for that reference (`revealed` / `assigned` / `redeemed`, the same filter the orderReference replay uses); returned or refunded keys are excluded. **Never pulls new inventory** and never creates a sale. Every call is audited as a key reveal.\n\nThis is the only read of key plaintext outside `POST /orders` / pull / export: `GET /orders` keeps never returning plaintext (certification case 16).\n\n**Route error codes:** `NOT_FOUND` (no live keys under the reference), `VALIDATION_FAILED`, `UNAUTHORIZED`, `FORBIDDEN`, `RATE_LIMIT_EXCEEDED`, `INTERNAL_ERROR`. See `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/orders/recover-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Cancel pre-order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "cancel"
              ]
            },
            "description": "**Cancel pre-order**\n\n**Capability-gated (`preorder`):** pre-order cancellation applies only to accounts with `whoami.capabilities.preorderEnabled: true` (the default). With the capability off, pre-order-phase products are not transactable and there is nothing to cancel.\n\nCancel active pre-order reservations by orderReference. Keys are returned to available inventory. Use **Idempotency-Key** for safe retries: a completed cancellation is replayed; a failed response such as 404 is never stored, so the same key runs again.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `CONFLICT` / invalid lifecycle transition |\n| CAT_* | Reservation/order kind mismatches |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Reservations cancelled",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "cancel"
                  ]
                },
                "description": "**Cancel pre-order**\n\n**Capability-gated (`preorder`):** pre-order cancellation applies only to accounts with `whoami.capabilities.preorderEnabled: true` (the default). With the capability off, pre-order-phase products are not transactable and there is nothing to cancel.\n\nCancel active pre-order reservations by orderReference. Keys are returned to available inventory. Use **Idempotency-Key** for safe retries: a completed cancellation is replayed; a failed response such as 404 is never stored, so the same key runs again.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `CONFLICT` / invalid lifecycle transition |\n| CAT_* | Reservation/order kind mismatches |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"orderReference\": \"store-order-10432\",\n    \"cancelled\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "cancel"
                  ]
                },
                "description": "**Cancel pre-order**\n\n**Capability-gated (`preorder`):** pre-order cancellation applies only to accounts with `whoami.capabilities.preorderEnabled: true` (the default). With the capability off, pre-order-phase products are not transactable and there is nothing to cancel.\n\nCancel active pre-order reservations by orderReference. Keys are returned to available inventory. Use **Idempotency-Key** for safe retries: a completed cancellation is replayed; a failed response such as 404 is never stored, so the same key runs again.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `CONFLICT` / invalid lifecycle transition |\n| CAT_* | Reservation/order kind mismatches |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Create bulk order (multi-SKU cart)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/bulk",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "bulk"
              ]
            },
            "description": "**Create bulk order (multi-SKU cart)**\n\nCreate order for multiple SKUs in one request (e.g. cart checkout or wholesale). On the launch contract (2026-04-29, which must now be pinned; it was the stamped default for unpinned requests **before 2026-09-01 UTC**) each item is processed independently and **partial success** is allowed (HTTP 200 with mixed line outcomes). Set **`strict: true`** for an all-or-nothing cart, which runs in two steps. First every line is validated without touching inventory: any failure yields **422** `VALIDATION_FAILED` with aggregated `details.issues`, and nothing is pulled or announced. Then every line is pulled before any line is billed, delivered or announced: a line refused at that point (for example **409** `NO_AVAILABLE_KEYS`) releases what the earlier lines took, and the request answers **that line's own code and status** with `details.strictCart` = `{ outcome, failedItemIndex, items[{ index, orderReference, status }] }`. `outcome` is `rolled_back` when every earlier line was released, and `rollback_incomplete` when at least one could not be released automatically: the cart still did not go through and the response carries no keys, so keep the `requestId` for support before you retry. **Since 2026-09-01 (UTC) the stamped default is the 2026-09-01 contract and an omitted `strict` defaults to `true`**; pin `X-Avrix-Api-Version: 2026-04-29` or send `strict: false` explicitly to keep partial success. The response `meta` echoes the effective `contractDate` and `strict` mode. Recommendation: always send `strict` explicitly so defaults never surprise you. Items for unreleased products are automatically reserved as pre-orders when strict checks pass and the fulfillment path chooses pre-order. Optional **integrationOrderContext** at root (cart-level) merges with each item's **integrationOrderContext** (item wins). Use Idempotency-Key for the whole batch; body must match for replay.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED` (per-line `details.issues`), `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, cart minimum errors |\n| CAT_* | Company visibility / BMA denials |\n| KEY_* | `NO_AVAILABLE_KEYS` on fulfilment paths |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/bulk`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"strict\": true,\n  \"items\": [\n    {\n      \"skuCode\": \"SANDBOX-ALWAYS-001\",\n      \"quantity\": 1,\n      \"orderReference\": \"store-order-10432-line-0\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 The cart ran. With `strict: true` (the default on contract date `2026-09-01` and later) every line is `fulfilled` or `pre-order`: a strict cart that cannot be completed in full answers an error status, never a 200. With `strict: false` every line stands alone, so the response can mix lines that went through with refused lines (`type: failed`, with the line's own `code`, `error` and `httpStatus`). `meta.strict` and `meta.contractDate` say which mode ran. The response is stored for replay only when every line went through; otherwise a retry with the same `Idempotency-Key` replays the lines that went through and runs the refused ones again.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/bulk",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "bulk"
                  ]
                },
                "description": "**Create bulk order (multi-SKU cart)**\n\nCreate order for multiple SKUs in one request (e.g. cart checkout or wholesale). On the launch contract (2026-04-29, which must now be pinned; it was the stamped default for unpinned requests **before 2026-09-01 UTC**) each item is processed independently and **partial success** is allowed (HTTP 200 with mixed line outcomes). Set **`strict: true`** for an all-or-nothing cart, which runs in two steps. First every line is validated without touching inventory: any failure yields **422** `VALIDATION_FAILED` with aggregated `details.issues`, and nothing is pulled or announced. Then every line is pulled before any line is billed, delivered or announced: a line refused at that point (for example **409** `NO_AVAILABLE_KEYS`) releases what the earlier lines took, and the request answers **that line's own code and status** with `details.strictCart` = `{ outcome, failedItemIndex, items[{ index, orderReference, status }] }`. `outcome` is `rolled_back` when every earlier line was released, and `rollback_incomplete` when at least one could not be released automatically: the cart still did not go through and the response carries no keys, so keep the `requestId` for support before you retry. **Since 2026-09-01 (UTC) the stamped default is the 2026-09-01 contract and an omitted `strict` defaults to `true`**; pin `X-Avrix-Api-Version: 2026-04-29` or send `strict: false` explicitly to keep partial success. The response `meta` echoes the effective `contractDate` and `strict` mode. Recommendation: always send `strict` explicitly so defaults never surprise you. Items for unreleased products are automatically reserved as pre-orders when strict checks pass and the fulfillment path chooses pre-order. Optional **integrationOrderContext** at root (cart-level) merges with each item's **integrationOrderContext** (item wins). Use Idempotency-Key for the whole batch; body must match for replay.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED` (per-line `details.issues`), `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, cart minimum errors |\n| CAT_* | Company visibility / BMA denials |\n| KEY_* | `NO_AVAILABLE_KEYS` on fulfilment paths |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/bulk`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"strict\": true,\n  \"items\": [\n    {\n      \"skuCode\": \"SANDBOX-ALWAYS-001\",\n      \"quantity\": 1,\n      \"orderReference\": \"store-order-10432-line-0\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"items\": [\n      {\n        \"skuCode\": \"EXAMPLE-STEAM-WW\",\n        \"skuId\": \"3d9827bf-292b-4aa8-8519-8b7637afdc9e\",\n        \"quantity\": 12,\n        \"orderReference\": \"store-order-10432\",\n        \"type\": \"fulfilled\",\n        \"keys\": [\n          \"XXXXX-XXXXX-XXXXX-XXXXX\"\n        ],\n        \"pulled\": 12,\n        \"reserved\": 1,\n        \"allocationId\": \"07f2b10b-8ee3-4cd2-8e1f-0d8617bf5939\",\n        \"orderId\": \"ord_zam675ya\",\n        \"economics\": {\n          \"currencyCode\": \"EUR\",\n          \"currencyExponent\": 2,\n          \"quantity\": 12,\n          \"unitPriceCents\": 2450,\n          \"unitPriceMinor\": 2450,\n          \"initialUnitPriceCents\": 2450,\n          \"initialUnitPriceMinor\": 2450,\n          \"totalPriceCents\": 2450,\n          \"totalPriceMinor\": 2450,\n          \"promo\": {\n            \"sourceType\": \"event\",\n            \"sourceId\": \"4d8c1993-1a1c-4c4b-84f0-1c92bb67ceda\"\n          },\n          \"publisherShareCents\": 2450,\n          \"publisherShareMinor\": 2450,\n          \"sellerShareCents\": 2450,\n          \"sellerShareMinor\": 2450,\n          \"platformFeeCents\": 2450,\n          \"platformFeeMinor\": 2450,\n          \"revenueSharePercent\": 20,\n          \"vatMinor\": 2450,\n          \"netMinor\": 2450,\n          \"transactionIds\": [\n            \"6b326fae-9f0b-47b2-8a6c-12aa676e8e08\"\n          ]\n        },\n        \"fulfilledAt\": \"2026-11-02T09:30:00Z\",\n        \"transactionIds\": [\n          \"b09e0789-dc06-4c13-837f-519cc2fa290e\"\n        ],\n        \"warnings\": [\n          \"example_warning\"\n        ],\n        \"contractTermId\": \"199570a7-be83-4f4d-8804-172acdb86960\",\n        \"contractTermVersion\": 1,\n        \"releaseDate\": \"2026-11-02T09:30:00Z\",\n        \"httpStatus\": 200,\n        \"fulfillmentState\": \"fulfilled\",\n        \"keyIds\": [\n          \"396ce3df-8814-4799-8f56-bee878af2c20\"\n        ]\n      }\n    ]\n  },\n  \"meta\": {\n    \"contractDate\": \"2026-11-02T09:30:00Z\",\n    \"strict\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/bulk",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "bulk"
                  ]
                },
                "description": "**Create bulk order (multi-SKU cart)**\n\nCreate order for multiple SKUs in one request (e.g. cart checkout or wholesale). On the launch contract (2026-04-29, which must now be pinned; it was the stamped default for unpinned requests **before 2026-09-01 UTC**) each item is processed independently and **partial success** is allowed (HTTP 200 with mixed line outcomes). Set **`strict: true`** for an all-or-nothing cart, which runs in two steps. First every line is validated without touching inventory: any failure yields **422** `VALIDATION_FAILED` with aggregated `details.issues`, and nothing is pulled or announced. Then every line is pulled before any line is billed, delivered or announced: a line refused at that point (for example **409** `NO_AVAILABLE_KEYS`) releases what the earlier lines took, and the request answers **that line's own code and status** with `details.strictCart` = `{ outcome, failedItemIndex, items[{ index, orderReference, status }] }`. `outcome` is `rolled_back` when every earlier line was released, and `rollback_incomplete` when at least one could not be released automatically: the cart still did not go through and the response carries no keys, so keep the `requestId` for support before you retry. **Since 2026-09-01 (UTC) the stamped default is the 2026-09-01 contract and an omitted `strict` defaults to `true`**; pin `X-Avrix-Api-Version: 2026-04-29` or send `strict: false` explicitly to keep partial success. The response `meta` echoes the effective `contractDate` and `strict` mode. Recommendation: always send `strict` explicitly so defaults never surprise you. Items for unreleased products are automatically reserved as pre-orders when strict checks pass and the fulfillment path chooses pre-order. Optional **integrationOrderContext** at root (cart-level) merges with each item's **integrationOrderContext** (item wins). Use Idempotency-Key for the whole batch; body must match for replay.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `VALIDATION_FAILED` (per-line `details.issues`), `INSUFFICIENT_INVENTORY`, `CONFLICT`, `IDEMPOTENCY_KEY_MISMATCH`, cart minimum errors |\n| CAT_* | Company visibility / BMA denials |\n| KEY_* | `NO_AVAILABLE_KEYS` on fulfilment paths |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/bulk`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"strict\": true,\n  \"items\": [\n    {\n      \"skuCode\": \"SANDBOX-ALWAYS-001\",\n      \"quantity\": 1,\n      \"orderReference\": \"store-order-10432-line-0\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Fetch order by readable id",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                ":orderId"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Fetch order by readable id**\n\nReturns aggregate fulfillment state for a single store order reference bundle identified by Avrix readable id (`ord_…`). **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Scopes:** any one of `seller:orders:read` (the documented scope), `seller:orders:write`, `seller:products:read` or `seller:keys:pull`, the same set as `GET /orders`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/{orderId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Order aggregate for the given readable id (`ord_…`): a superset of the order's `GET /orders` row, with `keyIds`, `totalCents`, `currencyCode`, `currencyExponent`, `createdAt`, `fulfilledAt` and `updatedAt`. No plaintext keys.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Fetch order by readable id**\n\nReturns aggregate fulfillment state for a single store order reference bundle identified by Avrix readable id (`ord_…`). **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Scopes:** any one of `seller:orders:read` (the documented scope), `seller:orders:write`, `seller:products:read` or `seller:keys:pull`, the same set as `GET /orders`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/{orderId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"orderReference\": \"store-order-10432\",\n    \"fulfilled\": [\n      {\n        \"skuCode\": \"EXAMPLE-STEAM-WW\",\n        \"allocationId\": \"91adfcfc-0bff-490a-8bbe-1ad817322a5a\",\n        \"fulfilledQuantity\": 12,\n        \"firstKeyPullId\": \"ce39fabe-113e-4b51-8980-4460786f3353\",\n        \"orderReadableId\": \"ord_szczrqk3\"\n      }\n    ],\n    \"preOrderActive\": [\n      {\n        \"skuCode\": \"EXAMPLE-STEAM-WW\",\n        \"allocationId\": \"c5251732-837e-4176-8436-27dd881dc616\",\n        \"reservedQuantity\": 12,\n        \"reservedUntil\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"status\": \"preordered\",\n    \"refunds\": [\n      {\n        \"refundId\": \"f7f84e79-cf50-449e-8bcd-714c2547c3d8\",\n        \"status\": \"pending\",\n        \"keyIds\": [\n          \"f15fc6a1-273d-4dfe-8b0c-d040c2aa1e6b\"\n        ],\n        \"refundReference\": \"rfnd_10432\",\n        \"refundIds\": [\n          \"d3802e11-eb23-499b-88f0-b64584b1d33d\"\n        ]\n      }\n    ],\n    \"keyIds\": [\n      \"5d368e7a-acb5-41f4-8539-666b8f3d2332\"\n    ],\n    \"totalMinor\": 2450,\n    \"currencyCode\": \"null\",\n    \"currencyExponent\": 2,\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"fulfilledAt\": \"2026-11-02T09:30:00Z\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"orderId\": \"ord_zvaja384\",\n    \"economics\": {\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"quantity\": 12,\n      \"unitPriceCents\": 2450,\n      \"unitPriceMinor\": 2450,\n      \"initialUnitPriceCents\": 2450,\n      \"initialUnitPriceMinor\": 2450,\n      \"totalPriceCents\": 2450,\n      \"totalPriceMinor\": 2450,\n      \"promo\": {\n        \"sourceType\": \"event\",\n        \"sourceId\": \"9229c42a-f2bb-4091-8d1c-f77d0372fe98\"\n      },\n      \"publisherShareCents\": 2450,\n      \"publisherShareMinor\": 2450,\n      \"sellerShareCents\": 2450,\n      \"sellerShareMinor\": 2450,\n      \"platformFeeCents\": 2450,\n      \"platformFeeMinor\": 2450,\n      \"revenueSharePercent\": 20,\n      \"vatMinor\": 2450,\n      \"netMinor\": 2450,\n      \"transactionIds\": [\n        \"ea7e68e5-1e97-4efe-8d46-60b22342036b\"\n      ]\n    },\n    \"parentOrderReference\": \"store-order-10432\",\n    \"lineIndex\": 1,\n    \"replacements\": [\n      {\n        \"replacementId\": \"99f72f57-628e-49df-8792-355d2c5598d2\",\n        \"status\": \"pending\",\n        \"reason\": \"already_redeemed\",\n        \"approval\": \"auto\",\n        \"replacedKeyId\": \"4a2e3ef1-68b3-40ae-839f-46fd360efb8c\",\n        \"keyId\": \"03233c32-007a-40e4-87ab-6d88d130a401\",\n        \"requestedAt\": \"2026-11-02T09:30:00Z\",\n        \"completedAt\": \"2026-11-02T09:30:00Z\",\n        \"decidedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"revocations\": [\n      {\n        \"keyId\": \"e4765873-8cfe-4e8c-8a50-6690aeb25cd9\",\n        \"reason\": \"leaked\",\n        \"revokedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ]\n  },\n  \"meta\": {\n    \"requestId\": \"c2ed3722-baca-4e05-84f2-16b92bfe2d7a\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Fetch order by readable id**\n\nReturns aggregate fulfillment state for a single store order reference bundle identified by Avrix readable id (`ord_…`). **Read model:** every order also has a durable record, written when it is placed and moved by fulfil, return, refund, cancellation and backorder expiry. It is compared with the delivery rows daily and is the source of `status` once durable reads are switched on for the environment; key-level line detail always comes from the delivery rows, and the response shape does not change.\n\n**Scopes:** any one of `seller:orders:read` (the documented scope), `seller:orders:write`, `seller:products:read` or `seller:keys:pull`, the same set as `GET /orders`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/orders/{orderId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"orderId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Extend hot-drop reservation TTL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/extend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                ":orderId",
                "extend"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Extend hot-drop reservation TTL**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/extend`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\n**Hot-drop only.** Extends an outstanding reservation TTL (idempotent; capped per reservation — **409** `RESERVATION_EXTEND_EXHAUSTED` when exhausted). `orderId` path parameter is the **hot-drop reservation UUID**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `RESERVATION_EXTEND_EXHAUSTED`, invalid reservation state |\n| CAT_* | `HOT_DROP_UNAVAILABLE` |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Hot-drop reservation TTL extended once (`data.reservationId`, `expiresAt`, `ttlSeconds`, `extendedOnce: true`).",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/extend",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "extend"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Extend hot-drop reservation TTL**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/extend`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\n**Hot-drop only.** Extends an outstanding reservation TTL (idempotent; capped per reservation — **409** `RESERVATION_EXTEND_EXHAUSTED` when exhausted). `orderId` path parameter is the **hot-drop reservation UUID**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `RESERVATION_EXTEND_EXHAUSTED`, invalid reservation state |\n| CAT_* | `HOT_DROP_UNAVAILABLE` |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"reservationId\": \"dcda7e11-d5f8-440e-89f3-bc44888d53fb\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"ttlSeconds\": 300,\n    \"extendedOnce\": true\n  },\n  \"meta\": {\n    \"requestId\": \"9b272f1e-3248-4858-8de9-c2bcba4b4471\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/extend",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "extend"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Extend hot-drop reservation TTL**\n\n**Deprecated name.** Use `POST /orders/reservations/{reservationId}/extend`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\n**Hot-drop only.** Extends an outstanding reservation TTL (idempotent; capped per reservation — **409** `RESERVATION_EXTEND_EXHAUSTED` when exhausted). `orderId` path parameter is the **hot-drop reservation UUID**.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| ORD_* | `NOT_FOUND`, `RESERVATION_EXTEND_EXHAUSTED`, invalid reservation state |\n| CAT_* | `HOT_DROP_UNAVAILABLE` |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"orderId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Extend a hot-drop reservation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/extend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "reservations",
                ":reservationId",
                "extend"
              ],
              "variable": [
                {
                  "key": "reservationId",
                  "value": "{{reservationId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Extend a hot-drop reservation**\n\nExtend a hot-drop reservation once, by the reservation's own id in the path. The same handler, idempotency and responses as `POST /orders/{orderId}/extend`, whose `orderId` parameter has always held the reservation id; that path is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Hot-drop reservation TTL extended once (`data.reservationId`, `expiresAt`, `ttlSeconds`, `extendedOnce: true`).",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/extend",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reservations",
                    ":reservationId",
                    "extend"
                  ],
                  "variable": [
                    {
                      "key": "reservationId",
                      "value": "{{reservationId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Extend a hot-drop reservation**\n\nExtend a hot-drop reservation once, by the reservation's own id in the path. The same handler, idempotency and responses as `POST /orders/{orderId}/extend`, whose `orderId` parameter has always held the reservation id; that path is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"reservationId\": \"41e12737-e8b9-41ba-8557-68059f757174\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"ttlSeconds\": 300,\n    \"extendedOnce\": true\n  },\n  \"meta\": {\n    \"requestId\": \"cb8148e3-7fff-461b-8b6b-aa4d6fc24eca\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/reservations/:reservationId/extend",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "reservations",
                    ":reservationId",
                    "extend"
                  ],
                  "variable": [
                    {
                      "key": "reservationId",
                      "value": "{{reservationId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Extend a hot-drop reservation**\n\nExtend a hot-drop reservation once, by the reservation's own id in the path. The same handler, idempotency and responses as `POST /orders/{orderId}/extend`, whose `orderId` parameter has always held the reservation id; that path is the deprecated name of this operation.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 410, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/reservations/{reservationId}/extend`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"reservationId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Revoke keyless fulfillment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/revoke",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "fulfillments",
                ":fulfillmentId",
                "revoke"
              ],
              "variable": [
                {
                  "key": "fulfillmentId",
                  "value": "{{fulfillmentId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Revoke keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nInvalidates a keyless redemption link for the seller company. Idempotent when the fulfillment is already terminal (`revoked`, `redeemed`, or `activated`). Does not return keys to inventory.\n\nRequires `seller:orders:manage`.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/revoke`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Revoked (or already terminal)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/revoke",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "fulfillments",
                    ":fulfillmentId",
                    "revoke"
                  ],
                  "variable": [
                    {
                      "key": "fulfillmentId",
                      "value": "{{fulfillmentId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Revoke keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nInvalidates a keyless redemption link for the seller company. Idempotent when the fulfillment is already terminal (`revoked`, `redeemed`, or `activated`). Does not return keys to inventory.\n\nRequires `seller:orders:manage`.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/revoke`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"fulfillmentId\": \"41a05ae6-2010-4211-8a10-937c8a41550e\",\n    \"revoked\": false,\n    \"status\": \"issued\"\n  },\n  \"meta\": {\n    \"requestId\": \"4088ffc3-3e4f-4478-8cf7-b417a50f3242\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/revoke",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "fulfillments",
                    ":fulfillmentId",
                    "revoke"
                  ],
                  "variable": [
                    {
                      "key": "fulfillmentId",
                      "value": "{{fulfillmentId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Revoke keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nInvalidates a keyless redemption link for the seller company. Idempotent when the fulfillment is already terminal (`revoked`, `redeemed`, or `activated`). Does not return keys to inventory.\n\nRequires `seller:orders:manage`.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/revoke`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"fulfillmentId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Regenerate keyless fulfillment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/regenerate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                "fulfillments",
                ":fulfillmentId",
                "regenerate"
              ],
              "variable": [
                {
                  "key": "fulfillmentId",
                  "value": "{{fulfillmentId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Regenerate keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nRevokes the existing hosted redemption link and issues a new fulfillment with a fresh URL. Returns a **new** `fulfillmentId`. Keeps the original expiry. Not allowed after buyer activation (`409` `ALREADY_ACTIVATED`), expiry (`409` `EXPIRED`), or when the key is refunded, returned, revoked or frozen (`409` `KEY_NOT_REPLACEABLE`).\n\nRequires `seller:orders:manage`. Currently supported for `hosted_redemption` only.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/regenerate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 New keyless delivery reference",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/regenerate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "fulfillments",
                    ":fulfillmentId",
                    "regenerate"
                  ],
                  "variable": [
                    {
                      "key": "fulfillmentId",
                      "value": "{{fulfillmentId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Regenerate keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nRevokes the existing hosted redemption link and issues a new fulfillment with a fresh URL. Returns a **new** `fulfillmentId`. Keeps the original expiry. Not allowed after buyer activation (`409` `ALREADY_ACTIVATED`), expiry (`409` `EXPIRED`), or when the key is refunded, returned, revoked or frozen (`409` `KEY_NOT_REPLACEABLE`).\n\nRequires `seller:orders:manage`. Currently supported for `hosted_redemption` only.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/regenerate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"items\": [\n      {\n        \"fulfillmentId\": \"c37a4cd8-4967-437f-879b-5fe2112e5896\",\n        \"keyId\": \"bded396a-62c7-403d-8217-ad11583be077\",\n        \"redemptionUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n        \"expiresAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"provider\": \"hosted_redemption\",\n    \"redemptionUrl\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"providerRef\": null,\n    \"fulfillmentId\": \"8fc0a7a4-ce09-454a-828c-93c7359ae99a\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"status\": \"issued\"\n  },\n  \"meta\": {\n    \"requestId\": \"d7fc28a2-27e3-4cf6-89be-7a2882b9ad25\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/fulfillments/:fulfillmentId/regenerate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    "fulfillments",
                    ":fulfillmentId",
                    "regenerate"
                  ],
                  "variable": [
                    {
                      "key": "fulfillmentId",
                      "value": "{{fulfillmentId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Regenerate keyless fulfillment**\n\n**Capability-gated (`keyless`, not GA):** keyless fulfilment requires the keyless capability — check `whoami.capabilityDetails.keyless`; without it keyless flows fail with `403 FEATURE_DISABLED`.\n\nRevokes the existing hosted redemption link and issues a new fulfillment with a fresh URL. Returns a **new** `fulfillmentId`. Keeps the original expiry. Not allowed after buyer activation (`409` `ALREADY_ACTIVATED`), expiry (`409` `EXPIRED`), or when the key is refunded, returned, revoked or frozen (`409` `KEY_NOT_REPLACEABLE`).\n\nRequires `seller:orders:manage`. Currently supported for `hosted_redemption` only.\n\n**Scopes:** `seller:orders:manage`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/fulfillments/{fulfillmentId}/regenerate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"fulfillmentId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Replace a delivered key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/keys/:keyId/replace",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                ":orderId",
                "keys",
                ":keyId",
                "replace"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}",
                  "description": "API key UUID — from GET /keys"
                },
                {
                  "key": "keyId",
                  "value": "{{keyId}}",
                  "description": "API key UUID — from GET /keys"
                }
              ]
            },
            "description": "**Replace a delivered key**\n\nReplace a key the buyer could not use (`already_redeemed`, `invalid`, `wrong_region`, `revoked`) with a fresh key from the **same allocation**. The old key is quarantined for the Content Owner's review. This is not a second sale: the order keeps its reference, sale and settlement, and no allocation capacity is consumed.\n\nWithin the Content Owner's replacement policy (default: 1 replacement per order and 10 per 30 days, auto-approved) the new key comes back at once with **200** (`keys`, `keyIds`). Outside it the request waits for the Content Owner with **202** `status: pending`; after approval `key.replaced` is sent and the key is read with `POST /orders/recover-keys`. Send an `Idempotency-Key` header (required); asking again for the same key returns the same replacement. `GET /orders/{orderId}` lists every replacement under `replacements[]`.\n\nErrors: **404** `NOT_FOUND` (order, or the key is not on it), **409** `KEY_NOT_REPLACEABLE` (the key was returned, refunded or replaced), **409** `NO_AVAILABLE_KEYS` (no key left in the allocation; retry with the same Idempotency-Key once stock arrives).\n\nSandbox: `SANDBOX-REPLACE-PENDING-001` always answers 202 and is approved a moment later.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/keys/{keyId}/replace`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"refund_requested\",\n  \"note\": \"Accepted — promoting campaign in week 36\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Replaced. The new key is in `keys` (plaintext, this response only) and `keyIds`.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/keys/:keyId/replace",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "keys",
                    ":keyId",
                    "replace"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "API key UUID — from GET /keys"
                    },
                    {
                      "key": "keyId",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Replace a delivered key**\n\nReplace a key the buyer could not use (`already_redeemed`, `invalid`, `wrong_region`, `revoked`) with a fresh key from the **same allocation**. The old key is quarantined for the Content Owner's review. This is not a second sale: the order keeps its reference, sale and settlement, and no allocation capacity is consumed.\n\nWithin the Content Owner's replacement policy (default: 1 replacement per order and 10 per 30 days, auto-approved) the new key comes back at once with **200** (`keys`, `keyIds`). Outside it the request waits for the Content Owner with **202** `status: pending`; after approval `key.replaced` is sent and the key is read with `POST /orders/recover-keys`. Send an `Idempotency-Key` header (required); asking again for the same key returns the same replacement. `GET /orders/{orderId}` lists every replacement under `replacements[]`.\n\nErrors: **404** `NOT_FOUND` (order, or the key is not on it), **409** `KEY_NOT_REPLACEABLE` (the key was returned, refunded or replaced), **409** `NO_AVAILABLE_KEYS` (no key left in the allocation; retry with the same Idempotency-Key once stock arrives).\n\nSandbox: `SANDBOX-REPLACE-PENDING-001` always answers 202 and is approved a moment later.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/keys/{keyId}/replace`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"reason\": \"refund_requested\",\n  \"note\": \"Accepted — promoting campaign in week 36\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"replacementId\": \"e24c8847-9bea-4510-87c5-af990d30c752\",\n    \"status\": \"completed\",\n    \"orderId\": \"ord_xw7qtfcd\",\n    \"orderReference\": \"store-order-10432\",\n    \"replacedKeyId\": \"37d9f3f5-56a5-48f1-8fc9-75e837a86afe\",\n    \"keyIds\": [\n      \"758b880b-5a7a-40f7-8b37-dc33c8ce2fce\"\n    ],\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"reason\": \"already_redeemed\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/keys/:keyId/replace",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "keys",
                    ":keyId",
                    "replace"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "API key UUID — from GET /keys"
                    },
                    {
                      "key": "keyId",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Replace a delivered key**\n\nReplace a key the buyer could not use (`already_redeemed`, `invalid`, `wrong_region`, `revoked`) with a fresh key from the **same allocation**. The old key is quarantined for the Content Owner's review. This is not a second sale: the order keeps its reference, sale and settlement, and no allocation capacity is consumed.\n\nWithin the Content Owner's replacement policy (default: 1 replacement per order and 10 per 30 days, auto-approved) the new key comes back at once with **200** (`keys`, `keyIds`). Outside it the request waits for the Content Owner with **202** `status: pending`; after approval `key.replaced` is sent and the key is read with `POST /orders/recover-keys`. Send an `Idempotency-Key` header (required); asking again for the same key returns the same replacement. `GET /orders/{orderId}` lists every replacement under `replacements[]`.\n\nErrors: **404** `NOT_FOUND` (order, or the key is not on it), **409** `KEY_NOT_REPLACEABLE` (the key was returned, refunded or replaced), **409** `NO_AVAILABLE_KEYS` (no key left in the allocation; retry with the same Idempotency-Key once stock arrives).\n\nSandbox: `SANDBOX-REPLACE-PENDING-001` always answers 202 and is approved a moment later.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/keys/{keyId}/replace`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"reason\": \"refund_requested\",\n  \"note\": \"Accepted — promoting campaign in week 36\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"orderId\",\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Fulfill a ready deferred order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/fulfill",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "orders",
                ":orderId",
                "fulfill"
              ],
              "variable": [
                {
                  "key": "orderId",
                  "value": "{{orderId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Fulfill a ready deferred order**\n\nAssigns and reveals keys for a durable preorder or backorder. Pre-orders and backorders are **capability-gated** (`whoami.capabilities.preorderEnabled` / `backorderEnabled`, both default true; a Content Owner can opt out) — without them no durable rows reach a revealable state. Allowed when status is `ready`, or `awaiting_release` / `awaiting_stock` if keys are already available. All-or-nothing: the full pending quantity is revealed or the call fails with `409 ORDER_NOT_READY` and no partial fulfillment. Idempotency-Key required. Scope: `seller:orders:fulfill` (v1 also accepts `seller:keys:pull` and `seller:orders:write`). Plaintext keys appear only in this response. The delivery is checked against what the order was placed with: on a wholesale allocation the unit price committed at placement (`expectedUnitPriceCents`), and the `integrationOrderContext` Avrix keeps with a pre-order or backorder placed on or after 2026-11-13, so a territory or price rule that needs them runs on the declaration made at placement.\n\n**Scopes (any one of):** `seller:orders:fulfill`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/fulfill`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Keys revealed. Order is fulfilled.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/fulfill",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "fulfill"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Fulfill a ready deferred order**\n\nAssigns and reveals keys for a durable preorder or backorder. Pre-orders and backorders are **capability-gated** (`whoami.capabilities.preorderEnabled` / `backorderEnabled`, both default true; a Content Owner can opt out) — without them no durable rows reach a revealable state. Allowed when status is `ready`, or `awaiting_release` / `awaiting_stock` if keys are already available. All-or-nothing: the full pending quantity is revealed or the call fails with `409 ORDER_NOT_READY` and no partial fulfillment. Idempotency-Key required. Scope: `seller:orders:fulfill` (v1 also accepts `seller:keys:pull` and `seller:orders:write`). Plaintext keys appear only in this response. The delivery is checked against what the order was placed with: on a wholesale allocation the unit price committed at placement (`expectedUnitPriceCents`), and the `integrationOrderContext` Avrix keeps with a pre-order or backorder placed on or after 2026-11-13, so a territory or price rule that needs them runs on the declaration made at placement.\n\n**Scopes (any one of):** `seller:orders:fulfill`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/fulfill`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"fulfilled\",\n    \"status\": \"fulfilled\",\n    \"orderId\": \"ord_b8vzz3w2\",\n    \"orderReference\": \"store-order-10432\",\n    \"allocationId\": \"7fe2e985-87f7-423f-8821-bc5e2641fc06\",\n    \"pulled\": 12,\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"keyIds\": [\n      \"e1bbd0fc-a640-4e0a-815d-945cd48e34c1\"\n    ],\n    \"activation\": {\n      \"type\": \"worldwide\",\n      \"countries\": [\n        \"DE\"\n      ]\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/orders/:orderId/fulfill",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "orders",
                    ":orderId",
                    "fulfill"
                  ],
                  "variable": [
                    {
                      "key": "orderId",
                      "value": "{{orderId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Fulfill a ready deferred order**\n\nAssigns and reveals keys for a durable preorder or backorder. Pre-orders and backorders are **capability-gated** (`whoami.capabilities.preorderEnabled` / `backorderEnabled`, both default true; a Content Owner can opt out) — without them no durable rows reach a revealable state. Allowed when status is `ready`, or `awaiting_release` / `awaiting_stock` if keys are already available. All-or-nothing: the full pending quantity is revealed or the call fails with `409 ORDER_NOT_READY` and no partial fulfillment. Idempotency-Key required. Scope: `seller:orders:fulfill` (v1 also accepts `seller:keys:pull` and `seller:orders:write`). Plaintext keys appear only in this response. The delivery is checked against what the order was placed with: on a wholesale allocation the unit price committed at placement (`expectedUnitPriceCents`), and the `integrationOrderContext` Avrix keeps with a pre-order or backorder placed on or after 2026-11-13, so a territory or price rule that needs them runs on the declaration made at placement.\n\n**Scopes (any one of):** `seller:orders:fulfill`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/orders/{orderId}/fulfill`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"orderId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Keys",
      "description": "API-key lifecycle (`GET/POST/DELETE /keys`) plus the fulfillment actions `POST /keys/pull`, `POST /keys/export`, and `POST /keys/return`. Scope: `seller:keys:write` for lifecycle, `seller:orders:write` (legacy `seller:keys:pull`) for pull, `seller:refunds:write` (or `seller:orders:write`) for return, `seller:keys:export` for export.",
      "item": [
        {
          "name": "GET — List seller API keys",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys?limit=50&cursor=&filters=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                  "disabled": true
                }
              ]
            },
            "description": "**List seller API keys**\n\n**Deprecated name.** Use `GET /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Each row also carries the key's `scopes`, `environment` and `allowedIps`, so a key inventory can be audited over the API. Requires `seller:keys:read` or `seller:keys:write`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Masked keys",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys?limit=50&cursor=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List seller API keys**\n\n**Deprecated name.** Use `GET /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Each row also carries the key's `scopes`, `environment` and `allowedIps`, so a key inventory can be audited over the API. Requires `seller:keys:read` or `seller:keys:write`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"46962dbf-0be0-49ce-8955-e47d1acf7d9f\",\n      \"name\": \"Example Game\",\n      \"prefix\": \"avrix_sk_sbx_\",\n      \"lastChars\": \"9f2c\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"expiresAt\": \"2026-11-02T09:30:00Z\",\n      \"lastUsedAt\": \"2026-11-02T09:30:00Z\",\n      \"status\": \"active\",\n      \"revokedAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/keys?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys?limit=50&cursor=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List seller API keys**\n\n**Deprecated name.** Use `GET /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Each row also carries the key's `scopes`, `environment` and `allowedIps`, so a key inventory can be audited over the API. Requires `seller:keys:read` or `seller:keys:write`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Create seller API key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys"
              ]
            },
            "description": "**Create seller API key**\n\n**Deprecated name.** Use `POST /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are exactly the `scopes` you send, each of which the calling key must hold (`403 INSUFFICIENT_SCOPE` naming them in `details.missingScopes` otherwise), or, when you send none, the server's default set intersected with the calling key's scopes; it inherits the calling key's environment (sandbox keys mint sandbox keys); it expires at `expiresAt` when you send one, which must be at least a minute ahead (`422` otherwise) and no later than the calling key's expiry (`403` otherwise), and otherwise when the calling key does; and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"checkout-service\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Key created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys"
                  ]
                },
                "description": "**Create seller API key**\n\n**Deprecated name.** Use `POST /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are exactly the `scopes` you send, each of which the calling key must hold (`403 INSUFFICIENT_SCOPE` naming them in `details.missingScopes` otherwise), or, when you send none, the server's default set intersected with the calling key's scopes; it inherits the calling key's environment (sandbox keys mint sandbox keys); it expires at `expiresAt` when you send one, which must be at least a minute ahead (`422` otherwise) and no later than the calling key's expiry (`403` otherwise), and otherwise when the calling key does; and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"checkout-service\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"d17a4cab-8e23-495b-8719-e08df3d792e0\",\n    \"name\": \"Example Game\",\n    \"key\": \"XXXXX-XXXXX-XXXXX-XXXXX\",\n    \"livemode\": true,\n    \"secretRedacted\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys"
                  ]
                },
                "description": "**Create seller API key**\n\n**Deprecated name.** Use `POST /api-keys`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are exactly the `scopes` you send, each of which the calling key must hold (`403 INSUFFICIENT_SCOPE` naming them in `details.missingScopes` otherwise), or, when you send none, the server's default set intersected with the calling key's scopes; it inherits the calling key's environment (sandbox keys mint sandbox keys); it expires at `expiresAt` when you send one, which must be at least a minute ahead (`422` otherwise) and no later than the calling key's expiry (`403` otherwise), and otherwise when the calling key does; and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"checkout-service\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "DELETE — Revoke seller API key",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "API key UUID — from GET /keys"
                }
              ]
            },
            "description": "**Revoke seller API key**\n\n**Deprecated name.** Use `DELETE /api-keys/{id}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "204 Key revoked",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Revoke seller API key**\n\n**Deprecated name.** Use `DELETE /api-keys/{id}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "No Content",
              "code": 204,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Revoke seller API key**\n\n**Deprecated name.** Use `DELETE /api-keys/{id}`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "PATCH — Update seller API key IP allowlist",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/:id/allowed-ips",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                ":id",
                "allowed-ips"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "API key UUID — from GET /keys"
                }
              ]
            },
            "description": "**Update seller API key IP allowlist**\n\n**Deprecated name.** Use `PATCH /api-keys/{id}/allowed-ips`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "204 Allowlist updated. Changes propagate within ~60s as cached entries refresh.",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id/allowed-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id",
                    "allowed-ips"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Update seller API key IP allowlist**\n\n**Deprecated name.** Use `PATCH /api-keys/{id}/allowed-ips`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "No Content",
              "code": 204,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id/allowed-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id",
                    "allowed-ips"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Update seller API key IP allowlist**\n\n**Deprecated name.** Use `PATCH /api-keys/{id}/allowed-ips`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Rotate seller API key secret",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/:id/rotate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                ":id",
                "rotate"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "API key UUID — from GET /keys"
                }
              ]
            },
            "description": "**Rotate seller API key secret**\n\n**Deprecated name.** Use `POST /api-keys/{id}/rotate`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"overlapSeconds\": 3600\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Key rotated",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id/rotate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id",
                    "rotate"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Rotate seller API key secret**\n\n**Deprecated name.** Use `POST /api-keys/{id}/rotate`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"overlapSeconds\": 3600\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"d2fd2421-bcf4-4527-8fa3-b1b6f8da59eb\",\n    \"secret\": \"whsec_8f2c1d0e9b7a6c5d4e3f2a1b0c9d8e7f\",\n    \"previousSecretExpiresAt\": \"2026-11-02T09:30:00Z\",\n    \"secretRedacted\": true\n  },\n  \"meta\": {\n    \"requestId\": \"b94c84e1-2f92-4a7d-8c21-80f5aebc122a\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/:id/rotate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    ":id",
                    "rotate"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "API key UUID — from GET /keys"
                    }
                  ]
                },
                "description": "**Rotate seller API key secret**\n\n**Deprecated name.** Use `POST /api-keys/{id}/rotate`, which runs the same handler. This path keeps working; nothing is scheduled for removal.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"overlapSeconds\": 3600\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Export keys as ZIP",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/export",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                "export"
              ]
            },
            "description": "**Export keys as ZIP**\n\nPull keys and return as a ZIP file (keys.txt inside) when keys are delivered immediately. Requires the opt-in `seller:keys:export` scope (`seller:keys:pull` and `seller:orders:write` do not grant it). **Pre-order** SKUs return JSON (`application/json`) with reserved counts instead of a ZIP (pre-order purchasing is capability-gated — `whoami.capabilities.preorderEnabled`, default true; a Content Owner can opt its products out). Same contract checks as POST /orders. Use **Idempotency-Key** header (same canonical body for replay). API catalog exports require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | Export windows, decrypt failures, `NO_AVAILABLE_KEYS` |\n| ORD_* | Pull parity / allocation enforcement |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes:** `seller:keys:export`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/export`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 ZIP file with keys.txt, or JSON body for pre-order (no ZIP)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/export",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "export"
                  ]
                },
                "description": "**Export keys as ZIP**\n\nPull keys and return as a ZIP file (keys.txt inside) when keys are delivered immediately. Requires the opt-in `seller:keys:export` scope (`seller:keys:pull` and `seller:orders:write` do not grant it). **Pre-order** SKUs return JSON (`application/json`) with reserved counts instead of a ZIP (pre-order purchasing is capability-gated — `whoami.capabilities.preorderEnabled`, default true; a Content Owner can opt its products out). Same contract checks as POST /orders. Use **Idempotency-Key** header (same canonical body for replay). API catalog exports require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | Export windows, decrypt failures, `NO_AVAILABLE_KEYS` |\n| ORD_* | Pull parity / allocation enforcement |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes:** `seller:keys:export`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/export`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"pre-order\",\n    \"skuId\": \"281d38df-5779-4f1f-8d97-f5dffc76f83b\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"orderReference\": \"store-order-10432\",\n    \"reserved\": 1,\n    \"allocationId\": \"071711e7-f983-420c-8bb3-c6fc224b3792\",\n    \"releaseDate\": \"2026-11-02T09:30:00Z\",\n    \"preorderStart\": \"2026-11-02T09:30:00Z\",\n    \"preorderEnd\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/export",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "export"
                  ]
                },
                "description": "**Export keys as ZIP**\n\nPull keys and return as a ZIP file (keys.txt inside) when keys are delivered immediately. Requires the opt-in `seller:keys:export` scope (`seller:keys:pull` and `seller:orders:write` do not grant it). **Pre-order** SKUs return JSON (`application/json`) with reserved counts instead of a ZIP (pre-order purchasing is capability-gated — `whoami.capabilities.preorderEnabled`, default true; a Content Owner can opt its products out). Same contract checks as POST /orders. Use **Idempotency-Key** header (same canonical body for replay). API catalog exports require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | Export windows, decrypt failures, `NO_AVAILABLE_KEYS` |\n| ORD_* | Pull parity / allocation enforcement |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes:** `seller:keys:export`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/export`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Pull keys",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/pull",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                "pull"
              ]
            },
            "description": "**Pull keys**\n\nPull keys from an allocation. Provide allocationId, or (skuId | skuCode) with quantity. **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries (same canonical body). API catalog pulls require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | `NO_AVAILABLE_KEYS`, decrypt/export failures, environment mismatch |\n| ORD_* | Contract / allocation denials merged into `pullError` |\n| CAT_* | SKU not entitled |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/pull`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Keys pulled or pre-order reserved",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/pull",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "pull"
                  ]
                },
                "description": "**Pull keys**\n\nPull keys from an allocation. Provide allocationId, or (skuId | skuCode) with quantity. **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries (same canonical body). API catalog pulls require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | `NO_AVAILABLE_KEYS`, decrypt/export failures, environment mismatch |\n| ORD_* | Contract / allocation denials merged into `pullError` |\n| CAT_* | SKU not entitled |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/pull`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"fulfilled\",\n    \"skuId\": \"48dcff94-ce20-4ec2-8c2d-4c800f4800b1\",\n    \"skuCode\": \"EXAMPLE-STEAM-WW\",\n    \"orderReference\": \"store-order-10432\",\n    \"keys\": [\n      \"XXXXX-XXXXX-XXXXX-XXXXX\"\n    ],\n    \"pulled\": 12,\n    \"allocationId\": \"99c8d06d-98f6-4c4a-82cc-72c877877672\",\n    \"fulfilledAt\": \"2026-11-02T09:30:00Z\",\n    \"orderReadableId\": \"ord_rje477e4\",\n    \"warnings\": [\n      \"example_warning\"\n    ],\n    \"activation\": {\n      \"type\": \"worldwide\",\n      \"countries\": [\n        \"DE\"\n      ]\n    },\n    \"keyIds\": [\n      \"a6dcec74-7f48-4f31-8b5a-dbf959a48af5\"\n    ]\n  },\n  \"contractTermId\": \"3428afdf-7aa7-46fe-891f-0430470a0579\",\n  \"contractTermVersion\": 1\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/pull",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "pull"
                  ]
                },
                "description": "**Pull keys**\n\nPull keys from an allocation. Provide allocationId, or (skuId | skuCode) with quantity. **Scopes:** `seller:orders:write` or the legacy `seller:keys:pull`. Use **Idempotency-Key** header for retries (same canonical body). API catalog pulls require **integrationOrderContext** with `salesCountryCode`, `salesPriceGrossMinor`, and `salesTaxRatePercent`.\n\n**Route error codes** (prefix hints for monitoring; canonical `code` unchanged):\n\n| Prefix | Typical `code` values |\n|---|---|\n| KEY_* | `NO_AVAILABLE_KEYS`, decrypt/export failures, environment mismatch |\n| ORD_* | Contract / allocation denials merged into `pullError` |\n| CAT_* | SKU not entitled |\n| | AUTH_* | `UNAUTHORIZED`, `FORBIDDEN`, `KEY_ENVIRONMENT_MISMATCH`, `IP_NOT_ALLOWED`, `IP_NOT_RESOLVABLE` |\n| RATE_* | `RATE_LIMIT_EXCEEDED` |\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Commercial enforcement (API allocations, production keys):** Territory allowlists, catalog list-price parity (`expectedUnitPriceCents` from preview), and buyer IP geo cross-check. Error codes: CATALOG_PRICE_NOT_SET, CATALOG_PRICE_MISMATCH, INVALID_CATALOG_PRICE, TERRITORY_NOT_ALLOWED_FOR_SKU, TERRITORY_EXCLUDED_FOR_RELEASE, SKU_REGION_UNRESOLVED, CONSUMER_IP_REQUIRED, CONSUMER_IP_INVALID, CONSUMER_GEO_MISMATCH, CONSUMER_IP_HIGH_RISK, CONSUMER_GEO_UNAVAILABLE, CONSUMER_GEO_ATTEST_REQUIRED, CONSUMER_RISK_HIGH, CONSUMER_RISK_UNAVAILABLE, SALES_COUNTRY_REQUIRED, TAX_DECLARATION_REQUIRED. See `https://docs.avrix.io/seller-api/territory` and `https://docs.avrix.io/seller-api/store-profiles`.\n\n**Scopes (any one of):** `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 402, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/pull`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"skuCode\": \"SANDBOX-ALWAYS-001\",\n  \"quantity\": 1,\n  \"orderReference\": \"store-order-10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — List key pulls",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/pulls?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                "pulls"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                  "disabled": true
                },
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Return only pulls with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                  "disabled": true
                },
                {
                  "key": "parentOrderReference",
                  "value": "",
                  "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                  "disabled": true
                }
              ]
            },
            "description": "**List key pulls**\n\nKey pull history, newest first: one row per game key your API keys pulled (`POST /orders`, `POST /keys/pull`, `POST /keys/export`). Rows name the pull (`keyPullId`) and the sale row it produced (`transactionId`, the id `GET /finance/api-sales/{transactionId}` reads). This is not a payment list: amounts are on `GET /finance/api-sales` and `GET /finance/ledger`.\n\nThe same handler, parameters and rows as `GET /transactions`, which is the deprecated name of this operation.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys/pulls`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Transactions list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/pulls?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "pulls"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Return only pulls with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List key pulls**\n\nKey pull history, newest first: one row per game key your API keys pulled (`POST /orders`, `POST /keys/pull`, `POST /keys/export`). Rows name the pull (`keyPullId`) and the sale row it produced (`transactionId`, the id `GET /finance/api-sales/{transactionId}` reads). This is not a payment list: amounts are on `GET /finance/api-sales` and `GET /finance/ledger`.\n\nThe same handler, parameters and rows as `GET /transactions`, which is the deprecated name of this operation.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys/pulls`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"keyPullId\": \"b5dca714-eed8-414e-849d-dc00457b4b91\",\n      \"transactionId\": \"099d5735-82de-4bd1-897d-40dc714f403f\",\n      \"allocationId\": \"638d711a-63e4-434e-8206-1ce00cce16ff\",\n      \"skuId\": \"89b18c2e-f2d3-4a38-889b-846eb020ec4e\",\n      \"skuCode\": \"EXAMPLE-STEAM-WW\",\n      \"quantity\": 12,\n      \"orderReference\": \"store-order-10432\",\n      \"pulledAt\": \"2026-11-02T09:30:00Z\",\n      \"salesCountryCode\": \"DE\",\n      \"detectedCountryCode\": \"off\",\n      \"countryMismatch\": true,\n      \"warnings\": [\n        \"COUNTRY_MISMATCH\"\n      ],\n      \"parentOrderReference\": \"store-order-10432\",\n      \"lineIndex\": 1\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/keys/pulls?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/pulls?limit=50&cursor=&orderReference=&from=&to=&filters=&parentOrderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "pulls"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from the previous page's `meta.nextCursor`. Omit for the first page.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Return only pulls with this order reference (exact match). Same as `filter[orderReference]=eq:<value>`; both together must name the same value.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Filter transactions from this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Filter transactions until this date (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON array filter DSL `[{ \"field\", \"op\", \"value\" }, …]` augmenting named params; unknown fields → **422**. Whitelist is route-specific.",
                      "disabled": true
                    },
                    {
                      "key": "parentOrderReference",
                      "value": "",
                      "description": "Only the pulls of one bulk cart (its `parentOrderReference`).",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List key pulls**\n\nKey pull history, newest first: one row per game key your API keys pulled (`POST /orders`, `POST /keys/pull`, `POST /keys/export`). Rows name the pull (`keyPullId`) and the sale row it produced (`transactionId`, the id `GET /finance/api-sales/{transactionId}` reads). This is not a payment list: amounts are on `GET /finance/api-sales` and `GET /finance/ledger`.\n\nThe same handler, parameters and rows as `GET /transactions`, which is the deprecated name of this operation.\n\nPaging keys and the cursor rules are on `https://docs.avrix.io/seller-api/pagination`.\n\n**Scopes (any one of):** `seller:orders:read`, `seller:orders:write`, `seller:products:read`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/keys/pulls`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Return keys after a refund",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/keys/return",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "keys",
                "return"
              ]
            },
            "description": "**Return keys after a refund**\n\nTake delivered keys out of circulation after you refunded the buyer. Deprecated: use `POST /refunds`, which does the same and also records your refund or chargeback reference. This operation keeps working for existing integrations; no removal date is set.\n\nKeys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it gives the real outcome and the call also ends any dispute freeze on the keys (`key.unfrozen`, resolution `refunded`). The Content Owner's refund window applies (`422 REFUND_WINDOW_EXPIRED`). Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Requires an **Idempotency-Key**. Emits `order.keys_returned` and `refund.completed`. See https://docs.avrix.io/seller-api/refunds-returns.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/return`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"reason\": \"customer_refund\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Keys quarantined and allocation headroom restored",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/return",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "return"
                  ]
                },
                "description": "**Return keys after a refund**\n\nTake delivered keys out of circulation after you refunded the buyer. Deprecated: use `POST /refunds`, which does the same and also records your refund or chargeback reference. This operation keeps working for existing integrations; no removal date is set.\n\nKeys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it gives the real outcome and the call also ends any dispute freeze on the keys (`key.unfrozen`, resolution `refunded`). The Content Owner's refund window applies (`422 REFUND_WINDOW_EXPIRED`). Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Requires an **Idempotency-Key**. Emits `order.keys_returned` and `refund.completed`. See https://docs.avrix.io/seller-api/refunds-returns.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/return`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"reason\": \"customer_refund\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returned\": 1,\n    \"keyDisposition\": \"quarantined\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/keys/return",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "keys",
                    "return"
                  ]
                },
                "description": "**Return keys after a refund**\n\nTake delivered keys out of circulation after you refunded the buyer. Deprecated: use `POST /refunds`, which does the same and also records your refund or chargeback reference. This operation keeps working for existing integrations; no removal date is set.\n\nKeys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it gives the real outcome and the call also ends any dispute freeze on the keys (`key.unfrozen`, resolution `refunded`). The Content Owner's refund window applies (`422 REFUND_WINDOW_EXPIRED`). Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Requires an **Idempotency-Key**. Emits `order.keys_returned` and `refund.completed`. See https://docs.avrix.io/seller-api/refunds-returns.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/keys/return`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"reason\": \"customer_refund\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Refunds",
      "description": "Refunds, chargebacks and dispute freezes: declare a refund or chargeback (`POST /refunds`), report a chargeback outcome, freeze and release delivered keys while a payment dispute is open, and read refund records. **All writes require `Idempotency-Key`.** Scopes: `seller:refunds:write` to write, `seller:refunds:read` to read (`seller:orders:write` and the legacy `seller:keys:pull` also accepted for both).",
      "item": [
        {
          "name": "GET — List refunds and chargebacks",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/refunds?limit=50&cursor=&orderReference=&refundReference=&chargebackReference=&status=pending&type=refund&keyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "refunds"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                  "disabled": true
                },
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Filter by store orderReference",
                  "disabled": true
                },
                {
                  "key": "refundReference",
                  "value": "",
                  "description": "The `refundReference` you sent on `POST /refunds`. Lists refunds and returns only.",
                  "disabled": true
                },
                {
                  "key": "chargebackReference",
                  "value": "",
                  "description": "The `chargebackReference` you sent on `POST /refunds`. Lists chargebacks only.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "pending",
                  "description": "Only records in this status. enum: pending, completed, chargeback_open, chargeback_lost, chargeback_won",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "refund",
                  "description": "Only records of this type. enum: refund, chargeback, return",
                  "disabled": true
                },
                {
                  "key": "keyId",
                  "value": "",
                  "description": "Only the record for this key. (UUID)",
                  "disabled": true
                }
              ]
            },
            "description": "**List refunds and chargebacks**\n\nPaginated refund and chargeback records, one per refunded key sold under the API model (keys sold under other business models have no sale record in Avrix). **Avrix never refunds your PSP**: refund the buyer first, then declare it with `POST /refunds`. Find a refund by the reference you sent (`refundReference`, `chargebackReference`), by `orderReference`, `keyId`, `status` or `type`; filters combine. A value outside the documented set is refused with `422 VALIDATION_FAILED` naming the field. Read one record with `GET /refunds/{refundId}`. Scopes: `seller:refunds:read` (also `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, or the legacy `seller:keys:pull`).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Refund list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds?limit=50&cursor=&orderReference=&refundReference=&chargebackReference=&status=pending&type=refund&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Filter by store orderReference",
                      "disabled": true
                    },
                    {
                      "key": "refundReference",
                      "value": "",
                      "description": "The `refundReference` you sent on `POST /refunds`. Lists refunds and returns only.",
                      "disabled": true
                    },
                    {
                      "key": "chargebackReference",
                      "value": "",
                      "description": "The `chargebackReference` you sent on `POST /refunds`. Lists chargebacks only.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Only records in this status. enum: pending, completed, chargeback_open, chargeback_lost, chargeback_won",
                      "disabled": true
                    },
                    {
                      "key": "type",
                      "value": "refund",
                      "description": "Only records of this type. enum: refund, chargeback, return",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Only the record for this key. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List refunds and chargebacks**\n\nPaginated refund and chargeback records, one per refunded key sold under the API model (keys sold under other business models have no sale record in Avrix). **Avrix never refunds your PSP**: refund the buyer first, then declare it with `POST /refunds`. Find a refund by the reference you sent (`refundReference`, `chargebackReference`), by `orderReference`, `keyId`, `status` or `type`; filters combine. A value outside the documented set is refused with `422 VALIDATION_FAILED` naming the field. Read one record with `GET /refunds/{refundId}`. Scopes: `seller:refunds:read` (also `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, or the legacy `seller:keys:pull`).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"20c8c24e-6204-4c6c-813d-a0783f82d2f6\",\n      \"status\": \"pending\",\n      \"type\": \"refund\",\n      \"keyId\": \"e16ba746-99a3-42b3-826b-e762cafea964\",\n      \"skuId\": \"38c0b9a7-e2d8-4032-855b-3499d0c2382b\",\n      \"productId\": \"6ff5886c-e14d-4065-8b34-2539cc775d63\",\n      \"orderReference\": \"store-order-10432\",\n      \"adjustmentReference\": \"adj_10432\",\n      \"reversalTransactionId\": \"3e990f0b-be2c-4237-881f-fc65e424ee49\",\n      \"salePriceCents\": 2450,\n      \"salePriceMinor\": 2450,\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"saleTimestamp\": \"2026-11-02T09:30:00Z\",\n      \"adjustedAt\": \"2026-11-02T09:30:00Z\",\n      \"occurredAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/refunds?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds?limit=50&cursor=&orderReference=&refundReference=&chargebackReference=&status=pending&type=refund&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Filter by store orderReference",
                      "disabled": true
                    },
                    {
                      "key": "refundReference",
                      "value": "",
                      "description": "The `refundReference` you sent on `POST /refunds`. Lists refunds and returns only.",
                      "disabled": true
                    },
                    {
                      "key": "chargebackReference",
                      "value": "",
                      "description": "The `chargebackReference` you sent on `POST /refunds`. Lists chargebacks only.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Only records in this status. enum: pending, completed, chargeback_open, chargeback_lost, chargeback_won",
                      "disabled": true
                    },
                    {
                      "key": "type",
                      "value": "refund",
                      "description": "Only records of this type. enum: refund, chargeback, return",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Only the record for this key. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List refunds and chargebacks**\n\nPaginated refund and chargeback records, one per refunded key sold under the API model (keys sold under other business models have no sale record in Avrix). **Avrix never refunds your PSP**: refund the buyer first, then declare it with `POST /refunds`. Find a refund by the reference you sent (`refundReference`, `chargebackReference`), by `orderReference`, `keyId`, `status` or `type`; filters combine. A value outside the documented set is refused with `422 VALIDATION_FAILED` naming the field. Read one record with `GET /refunds/{refundId}`. Scopes: `seller:refunds:read` (also `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, or the legacy `seller:keys:pull`).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Declare a refund or chargeback",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/refunds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "refunds"
              ]
            },
            "description": "**Declare a refund or chargeback**\n\nTell Avrix that you refunded a buyer, or that a buyer's payment was charged back, so the keys of that sale leave circulation. Avrix never moves the money: refund the buyer in your own payment provider first. This is the call to use for every refund and chargeback you give a buyer (`POST /keys/return` does the same without references and is kept for existing integrations). To ask the Content Owner for a refund or a replacement instead, file a return request with `POST /returns`.\n\nBefore calling, `POST /refunds/preview` answers per key whether it can be refunded, until when, and what will happen to it.\n\nWhat happens to the keys (`keyDisposition`): keys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it says `held`, `quarantined` or `mixed` (both, in one call). Each refunded key sold under the API model gets a refund record: `refunds[].id` is the id `GET /refunds/{refundId}` reads. Keys sold under other business models have no sale record in Avrix and get none.\n\nA refund (`type: refund`) is accepted within the Content Owner's refund window (`422 REFUND_WINDOW_EXPIRED` after it); chargebacks are never windowed. Any dispute freeze on the keys ends (`key.unfrozen`, resolution `refunded` or `chargeback`). From `2026-12-01` the order's status follows its keys: a partial refund leaves the order `fulfilled`, and it reads `refunded` once every key is refunded. Before that date the `orderReference` you send is marked `refunded` whatever the keys.\n\nEmits `order.keys_returned` (inventory side), `refund.completed` (the refund record) and, for `type: chargeback`, `chargeback.opened`. Requires `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`) and an `Idempotency-Key`.\n\nRequest `reason` is accepted for compatibility but ignored. Inventory stores a canonical code (`api_refund` or `chargeback` from `type`). Partner text belongs on `refundReference` or `chargebackReference`.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"refund\",\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"refundReference\": \"psp_refund_10432\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Refund or chargeback accepted and keys quarantined",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds"
                  ]
                },
                "description": "**Declare a refund or chargeback**\n\nTell Avrix that you refunded a buyer, or that a buyer's payment was charged back, so the keys of that sale leave circulation. Avrix never moves the money: refund the buyer in your own payment provider first. This is the call to use for every refund and chargeback you give a buyer (`POST /keys/return` does the same without references and is kept for existing integrations). To ask the Content Owner for a refund or a replacement instead, file a return request with `POST /returns`.\n\nBefore calling, `POST /refunds/preview` answers per key whether it can be refunded, until when, and what will happen to it.\n\nWhat happens to the keys (`keyDisposition`): keys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it says `held`, `quarantined` or `mixed` (both, in one call). Each refunded key sold under the API model gets a refund record: `refunds[].id` is the id `GET /refunds/{refundId}` reads. Keys sold under other business models have no sale record in Avrix and get none.\n\nA refund (`type: refund`) is accepted within the Content Owner's refund window (`422 REFUND_WINDOW_EXPIRED` after it); chargebacks are never windowed. Any dispute freeze on the keys ends (`key.unfrozen`, resolution `refunded` or `chargeback`). From `2026-12-01` the order's status follows its keys: a partial refund leaves the order `fulfilled`, and it reads `refunded` once every key is refunded. Before that date the `orderReference` you send is marked `refunded` whatever the keys.\n\nEmits `order.keys_returned` (inventory side), `refund.completed` (the refund record) and, for `type: chargeback`, `chargeback.opened`. Requires `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`) and an `Idempotency-Key`.\n\nRequest `reason` is accepted for compatibility but ignored. Inventory stores a canonical code (`api_refund` or `chargeback` from `type`). Partner text belongs on `refundReference` or `chargebackReference`.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"refund\",\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"refundReference\": \"psp_refund_10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returned\": 1,\n    \"refundReference\": \"rfnd_10432\",\n    \"chargebackReference\": \"chbk_10432\",\n    \"orderReference\": \"store-order-10432\",\n    \"occurredAt\": \"2026-11-02T09:30:00Z\",\n    \"requested\": 1,\n    \"skipped\": [\n      {\n        \"keyId\": \"8c5c2045-0c13-4fd2-8e59-ebb79267ec67\",\n        \"reason\": \"no_live_key\"\n      }\n    ],\n    \"keyDisposition\": \"quarantined\",\n    \"type\": \"refund\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds"
                  ]
                },
                "description": "**Declare a refund or chargeback**\n\nTell Avrix that you refunded a buyer, or that a buyer's payment was charged back, so the keys of that sale leave circulation. Avrix never moves the money: refund the buyer in your own payment provider first. This is the call to use for every refund and chargeback you give a buyer (`POST /keys/return` does the same without references and is kept for existing integrations). To ask the Content Owner for a refund or a replacement instead, file a return request with `POST /returns`.\n\nBefore calling, `POST /refunds/preview` answers per key whether it can be refunded, until when, and what will happen to it.\n\nWhat happens to the keys (`keyDisposition`): keys sold under a revenue-share agreement stay with you (`held`); every other key is quarantined and never sold again, and the allocation headroom is restored. Before contract date `2026-12-01` the response always says `quarantined`; from `2026-12-01` it says `held`, `quarantined` or `mixed` (both, in one call). Each refunded key sold under the API model gets a refund record: `refunds[].id` is the id `GET /refunds/{refundId}` reads. Keys sold under other business models have no sale record in Avrix and get none.\n\nA refund (`type: refund`) is accepted within the Content Owner's refund window (`422 REFUND_WINDOW_EXPIRED` after it); chargebacks are never windowed. Any dispute freeze on the keys ends (`key.unfrozen`, resolution `refunded` or `chargeback`). From `2026-12-01` the order's status follows its keys: a partial refund leaves the order `fulfilled`, and it reads `refunded` once every key is refunded. Before that date the `orderReference` you send is marked `refunded` whatever the keys.\n\nEmits `order.keys_returned` (inventory side), `refund.completed` (the refund record) and, for `type: chargeback`, `chargeback.opened`. Requires `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`) and an `Idempotency-Key`.\n\nRequest `reason` is accepted for compatibility but ignored. Inventory stores a canonical code (`api_refund` or `chargeback` from `type`). Partner text belongs on `refundReference` or `chargebackReference`.\n\nSee `https://docs.avrix.io/seller-api/errors`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/refunds`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"refund\",\n  \"keyIds\": [\n    \"7c9e6679-7425-40de-944b-e07fc1f90ae7\"\n  ],\n  \"refundReference\": \"psp_refund_10432\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Freeze keys for a dispute",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/disputes/freeze",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "disputes",
                "freeze"
              ]
            },
            "description": "**Freeze keys for a dispute**\n\nWhile a payment dispute is open, freeze the delivered keys: `POST /orders/recover-keys` withholds them (`frozen[]`) and `POST /orders/{orderId}/keys/{keyId}/replace` refuses them. The freeze ends when you release it (`POST /disputes/{freezeId}/release`), when `POST /refunds` refunds or charges back its keys (`status: converted`), or at `expiresAt` (default 30 days, at most 90). `key.frozen` and `key.unfrozen` report every change. Send an `Idempotency-Key` header (required). List your freezes with `GET /disputes`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/freeze`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keyIds\": [\n    \"{{keyId}}\"\n  ],\n  \"reason\": \"refund_requested\",\n  \"disputeReference\": \"string\",\n  \"expiresInDays\": 30\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Frozen. Keys that could not be frozen are listed in `skipped`.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/freeze",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    "freeze"
                  ]
                },
                "description": "**Freeze keys for a dispute**\n\nWhile a payment dispute is open, freeze the delivered keys: `POST /orders/recover-keys` withholds them (`frozen[]`) and `POST /orders/{orderId}/keys/{keyId}/replace` refuses them. The freeze ends when you release it (`POST /disputes/{freezeId}/release`), when `POST /refunds` refunds or charges back its keys (`status: converted`), or at `expiresAt` (default 30 days, at most 90). `key.frozen` and `key.unfrozen` report every change. Send an `Idempotency-Key` header (required). List your freezes with `GET /disputes`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/freeze`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"{{keyId}}\"\n  ],\n  \"reason\": \"refund_requested\",\n  \"disputeReference\": \"string\",\n  \"expiresInDays\": 30\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"freezeId\": \"6a0f8e2c-1d3b-4e5f-9a7b-2c4d6e8f0a1b\",\n    \"status\": \"active\",\n    \"reason\": \"payment_dispute\",\n    \"disputeReference\": \"dp_8812\",\n    \"expiresAt\": \"2027-01-01T10:00:00Z\",\n    \"frozen\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"orderReference\": \"ORD-10042\"\n      }\n    ],\n    \"skipped\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/freeze",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    "freeze"
                  ]
                },
                "description": "**Freeze keys for a dispute**\n\nWhile a payment dispute is open, freeze the delivered keys: `POST /orders/recover-keys` withholds them (`frozen[]`) and `POST /orders/{orderId}/keys/{keyId}/replace` refuses them. The freeze ends when you release it (`POST /disputes/{freezeId}/release`), when `POST /refunds` refunds or charges back its keys (`status: converted`), or at `expiresAt` (default 30 days, at most 90). `key.frozen` and `key.unfrozen` report every change. Send an `Idempotency-Key` header (required). List your freezes with `GET /disputes`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/freeze`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"{{keyId}}\"\n  ],\n  \"reason\": \"refund_requested\",\n  \"disputeReference\": \"string\",\n  \"expiresInDays\": 30\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Release a dispute freeze",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId/release",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "disputes",
                ":freezeId",
                "release"
              ],
              "variable": [
                {
                  "key": "freezeId",
                  "value": "{{freezeId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Release a dispute freeze**\n\nEnd a freeze (the dispute was withdrawn or won): the keys are recoverable again and `key.unfrozen` is sent with `resolution: released`. Send an `Idempotency-Key` header (required). Read the freeze back with `GET /disputes/{freezeId}`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/{freezeId}/release`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Released",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId/release",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    ":freezeId",
                    "release"
                  ],
                  "variable": [
                    {
                      "key": "freezeId",
                      "value": "{{freezeId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Release a dispute freeze**\n\nEnd a freeze (the dispute was withdrawn or won): the keys are recoverable again and `key.unfrozen` is sent with `resolution: released`. Send an `Idempotency-Key` header (required). Read the freeze back with `GET /disputes/{freezeId}`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/{freezeId}/release`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"freezeId\": \"b9c401d3-f745-4ea7-8f0d-9a7ba1a38f31\",\n    \"status\": \"released\",\n    \"keyIds\": [\n      \"436dc8ea-bfde-45e0-8334-6f0288f22483\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId/release",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    ":freezeId",
                    "release"
                  ],
                  "variable": [
                    {
                      "key": "freezeId",
                      "value": "{{freezeId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Release a dispute freeze**\n\nEnd a freeze (the dispute was withdrawn or won): the keys are recoverable again and `key.unfrozen` is sent with `resolution: released`. Send an `Idempotency-Key` header (required). Read the freeze back with `GET /disputes/{freezeId}`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/disputes/{freezeId}/release`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"freezeId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — List dispute freezes",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/disputes?limit=50&cursor=&status=active&disputeReference=&keyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "disputes"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "active",
                  "description": "Only freezes in this status. enum: active, released, converted, expired",
                  "disabled": true
                },
                {
                  "key": "disputeReference",
                  "value": "",
                  "description": "The `disputeReference` you sent on `POST /disputes/freeze`.",
                  "disabled": true
                },
                {
                  "key": "keyId",
                  "value": "",
                  "description": "Only freezes that include this key. (UUID)",
                  "disabled": true
                }
              ]
            },
            "description": "**List dispute freezes**\n\nYour dispute freezes, newest first, each with its keys and how it ended. Filter by `status`, `disputeReference` (the reference you sent on `POST /disputes/freeze`) or `keyId`. In the shared sandbox only the freezes your API key opened are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Dispute freezes",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes?limit=50&cursor=&status=active&disputeReference=&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "active",
                      "description": "Only freezes in this status. enum: active, released, converted, expired",
                      "disabled": true
                    },
                    {
                      "key": "disputeReference",
                      "value": "",
                      "description": "The `disputeReference` you sent on `POST /disputes/freeze`.",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Only freezes that include this key. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List dispute freezes**\n\nYour dispute freezes, newest first, each with its keys and how it ended. Filter by `status`, `disputeReference` (the reference you sent on `POST /disputes/freeze`) or `keyId`. In the shared sandbox only the freezes your API key opened are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"freezeId\": \"6a0f8e2c-1d3b-4e5f-9a7b-2c4d6e8f0a1b\",\n      \"status\": \"active\",\n      \"resolution\": null,\n      \"reason\": \"payment_dispute\",\n      \"disputeReference\": \"dp_8812\",\n      \"createdAt\": \"2026-12-02T10:00:00Z\",\n      \"expiresAt\": \"2027-01-01T10:00:00Z\",\n      \"endedAt\": null,\n      \"keyIds\": [\n        \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\"\n      ],\n      \"orderReferences\": [\n        \"ORD-10042\"\n      ],\n      \"keys\": [\n        {\n          \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n          \"orderReference\": \"ORD-10042\",\n          \"active\": true\n        }\n      ]\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"hasMore\": false,\n    \"nextCursor\": null,\n    \"nextUrl\": null\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes?limit=50&cursor=&status=active&disputeReference=&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "active",
                      "description": "Only freezes in this status. enum: active, released, converted, expired",
                      "disabled": true
                    },
                    {
                      "key": "disputeReference",
                      "value": "",
                      "description": "The `disputeReference` you sent on `POST /disputes/freeze`.",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Only freezes that include this key. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List dispute freezes**\n\nYour dispute freezes, newest first, each with its keys and how it ended. Filter by `status`, `disputeReference` (the reference you sent on `POST /disputes/freeze`) or `keyId`. In the shared sandbox only the freezes your API key opened are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get a dispute freeze",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "disputes",
                ":freezeId"
              ],
              "variable": [
                {
                  "key": "freezeId",
                  "value": "{{freezeId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get a dispute freeze**\n\nOne dispute freeze with its keys, its status and, once it ended, how. 404 when it is not yours (in the shared sandbox: not opened by your API key). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes/{freezeId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The freeze",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    ":freezeId"
                  ],
                  "variable": [
                    {
                      "key": "freezeId",
                      "value": "{{freezeId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a dispute freeze**\n\nOne dispute freeze with its keys, its status and, once it ended, how. 404 when it is not yours (in the shared sandbox: not opened by your API key). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes/{freezeId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"freezeId\": \"6a0f8e2c-1d3b-4e5f-9a7b-2c4d6e8f0a1b\",\n    \"status\": \"active\",\n    \"resolution\": null,\n    \"reason\": \"payment_dispute\",\n    \"disputeReference\": \"dp_8812\",\n    \"createdAt\": \"2026-12-02T10:00:00Z\",\n    \"expiresAt\": \"2027-01-01T10:00:00Z\",\n    \"endedAt\": null,\n    \"keyIds\": [\n      \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\"\n    ],\n    \"orderReferences\": [\n      \"ORD-10042\"\n    ],\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"orderReference\": \"ORD-10042\",\n        \"active\": true\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/disputes/:freezeId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "disputes",
                    ":freezeId"
                  ],
                  "variable": [
                    {
                      "key": "freezeId",
                      "value": "{{freezeId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a dispute freeze**\n\nOne dispute freeze with its keys, its status and, once it ended, how. 404 when it is not yours (in the shared sandbox: not opened by your API key). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/disputes/{freezeId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"freezeId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get refund by id",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/refunds/:refundId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "refunds",
                ":refundId"
              ],
              "variable": [
                {
                  "key": "refundId",
                  "value": "{{refundId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get refund by id**\n\nSingle refund/chargeback status row. `refundId` is the sale transaction id from GET /refunds. Scopes: same as GET /refunds.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds/{refundId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Refund detail",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds/:refundId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds",
                    ":refundId"
                  ],
                  "variable": [
                    {
                      "key": "refundId",
                      "value": "{{refundId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get refund by id**\n\nSingle refund/chargeback status row. `refundId` is the sale transaction id from GET /refunds. Scopes: same as GET /refunds.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds/{refundId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"d1bf6244-6a59-457a-83ec-4573c5d70b47\",\n    \"status\": \"pending\",\n    \"type\": \"refund\",\n    \"keyId\": \"a0de64ed-64f7-4e76-85ba-b8e914a26cd4\",\n    \"skuId\": \"d904c994-f566-46d9-89df-b1291d3ef86c\",\n    \"productId\": \"d0304eaa-1faa-4ced-834d-553fe348c225\",\n    \"orderReference\": \"store-order-10432\",\n    \"adjustmentReference\": \"adj_10432\",\n    \"reversalTransactionId\": \"0a4de534-795c-43f9-8eb7-796d32003797\",\n    \"salePriceCents\": 2450,\n    \"salePriceMinor\": 2450,\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"saleTimestamp\": \"2026-11-02T09:30:00Z\",\n    \"adjustedAt\": \"2026-11-02T09:30:00Z\",\n    \"occurredAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds/:refundId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds",
                    ":refundId"
                  ],
                  "variable": [
                    {
                      "key": "refundId",
                      "value": "{{refundId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get refund by id**\n\nSingle refund/chargeback status row. `refundId` is the sale transaction id from GET /refunds. Scopes: same as GET /refunds.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/refunds/{refundId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"refundId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Check refund eligibility",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/refunds/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "refunds",
                "preview"
              ]
            },
            "description": "**Check refund eligibility**\n\nAnswers, per key, whether `POST /refunds` would accept it: whether it can be refunded or charged back, why not, the refund window and its end (`refundableUntil`), what a refund would do to the key (`keyDisposition`) and any open dispute freeze. Changes nothing, so it takes no `Idempotency-Key`. Select keys as on `POST /refunds` (`keyIds`, or `quantity` with `orderReference`), or send `orderReference` alone for every live key of the order (at most 100). The rolling 30-day refund limit per allocation is not evaluated here (`REFUND_LIMIT_REACHED` on `POST /refunds`). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/refunds/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"refund\",\n  \"orderReference\": \"ORD-10042\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Eligibility per key",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds/preview",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds",
                    "preview"
                  ]
                },
                "description": "**Check refund eligibility**\n\nAnswers, per key, whether `POST /refunds` would accept it: whether it can be refunded or charged back, why not, the refund window and its end (`refundableUntil`), what a refund would do to the key (`keyDisposition`) and any open dispute freeze. Changes nothing, so it takes no `Idempotency-Key`. Select keys as on `POST /refunds` (`keyIds`, or `quantity` with `orderReference`), or send `orderReference` alone for every live key of the order (at most 100). The rolling 30-day refund limit per allocation is not evaluated here (`REFUND_LIMIT_REACHED` on `POST /refunds`). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/refunds/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"refund\",\n  \"orderReference\": \"ORD-10042\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"type\": \"refund\",\n    \"orderReference\": \"ORD-10042\",\n    \"eligible\": true,\n    \"checkedAt\": \"2026-12-02T10:00:00Z\",\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"orderReference\": \"ORD-10042\",\n        \"eligible\": true,\n        \"reason\": null,\n        \"keyStatus\": \"revealed\",\n        \"businessModel\": \"wholesale\",\n        \"keyDisposition\": \"quarantined\",\n        \"soldAt\": \"2026-11-30T09:12:00Z\",\n        \"windowDays\": 14,\n        \"refundableUntil\": \"2026-12-14T09:12:00Z\",\n        \"frozen\": null\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/refunds/preview",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "refunds",
                    "preview"
                  ]
                },
                "description": "**Check refund eligibility**\n\nAnswers, per key, whether `POST /refunds` would accept it: whether it can be refunded or charged back, why not, the refund window and its end (`refundableUntil`), what a refund would do to the key (`keyDisposition`) and any open dispute freeze. Changes nothing, so it takes no `Idempotency-Key`. Select keys as on `POST /refunds` (`keyIds`, or `quantity` with `orderReference`), or send `orderReference` alone for every live key of the order (at most 100). The rolling 30-day refund limit per allocation is not evaluated here (`REFUND_LIMIT_REACHED` on `POST /refunds`). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/refunds/preview`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"refund\",\n  \"orderReference\": \"ORD-10042\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Resolve a chargeback dispute",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/chargebacks/resolve",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "chargebacks",
                "resolve"
              ]
            },
            "description": "**Resolve a chargeback dispute**\n\nReport the outcome of a payment-provider dispute for a chargeback previously declared via `POST /refunds` with `type: \"chargeback\"`. Resolves the whole group sharing the same `chargebackReference` in a single atomic update. Winning means you kept the buyer's money, so the sale stands again and the content owner's share plus the platform commission are restored on a later settlement; losing confirms the reversal already applied when the chargeback was declared. Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Use `Idempotency-Key` for safe retries.\n\nReturns `404` when `chargebackReference` is not found for your company, and `409` (with the current `adjustmentStatus` in the message) when the chargeback is not in the `chargeback_open` state.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/chargebacks/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"chargebackReference\": \"psp_dispute_10432\",\n  \"outcome\": \"won\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Chargeback resolved",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/chargebacks/resolve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "chargebacks",
                    "resolve"
                  ]
                },
                "description": "**Resolve a chargeback dispute**\n\nReport the outcome of a payment-provider dispute for a chargeback previously declared via `POST /refunds` with `type: \"chargeback\"`. Resolves the whole group sharing the same `chargebackReference` in a single atomic update. Winning means you kept the buyer's money, so the sale stands again and the content owner's share plus the platform commission are restored on a later settlement; losing confirms the reversal already applied when the chargeback was declared. Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Use `Idempotency-Key` for safe retries.\n\nReturns `404` when `chargebackReference` is not found for your company, and `409` (with the current `adjustmentStatus` in the message) when the chargeback is not in the `chargeback_open` state.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/chargebacks/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"chargebackReference\": \"psp_dispute_10432\",\n  \"outcome\": \"won\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"chargebackReference\": \"chbk_10432\",\n    \"outcome\": \"won\",\n    \"resolved\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/chargebacks/resolve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "chargebacks",
                    "resolve"
                  ]
                },
                "description": "**Resolve a chargeback dispute**\n\nReport the outcome of a payment-provider dispute for a chargeback previously declared via `POST /refunds` with `type: \"chargeback\"`. Resolves the whole group sharing the same `chargebackReference` in a single atomic update. Winning means you kept the buyer's money, so the sale stands again and the content owner's share plus the platform commission are restored on a later settlement; losing confirms the reversal already applied when the chargeback was declared. Requires `seller:refunds:write` or `seller:orders:write`; the legacy `seller:keys:pull` is also accepted. Use `Idempotency-Key` for safe retries.\n\nReturns `404` when `chargebackReference` is not found for your company, and `409` (with the current `adjustmentStatus` in the message) when the chargeback is not in the `chargeback_open` state.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/chargebacks/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"chargebackReference\": \"psp_dispute_10432\",\n  \"outcome\": \"won\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Promotions",
      "description": "Platform event shares and custom deals from vendors. List/detail/accept/decline. Scopes: `seller:promotions:read`, `seller:promotions:respond`.",
      "item": [
        {
          "name": "GET — Get promotions summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/summary",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "summary"
              ]
            },
            "description": "**Get promotions summary**\n\nCounts of platform event shares and custom deals by state. Shares the vendor has not sent yet are not counted. Requires seller:promotions:read scope.\n\nOn contract date `2026-12-01` and later a failed read of the deals answers `503` or `504` (or a sanitized `500`) instead of `200` with zero deal counts.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Summary counts",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "summary"
                  ]
                },
                "description": "**Get promotions summary**\n\nCounts of platform event shares and custom deals by state. Shares the vendor has not sent yet are not counted. Requires seller:promotions:read scope.\n\nOn contract date `2026-12-01` and later a failed read of the deals answers `503` or `504` (or a sanitized `500`) instead of `200` with zero deal counts.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"shares\": {\n      \"pending\": 1,\n      \"accepted\": 1,\n      \"declined\": 1,\n      \"expired\": 1,\n      \"vendor_withdrawn\": 1,\n      \"total\": 2450\n    },\n    \"deals\": {\n      \"pending\": 1,\n      \"approved\": 1,\n      \"rejected\": 1,\n      \"expired\": 1,\n      \"total\": 2450\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "summary"
                  ]
                },
                "description": "**Get promotions summary**\n\nCounts of platform event shares and custom deals by state. Shares the vendor has not sent yet are not counted. Requires seller:promotions:read scope.\n\nOn contract date `2026-12-01` and later a failed read of the deals answers `503` or `504` (or a sanitized `500`) instead of `200` with zero deal counts.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List platform event shares",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/shares?status=&vendor=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "shares"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "",
                  "description": "Comma-separated: pending, accepted, declined, expired, vendor_withdrawn",
                  "disabled": true
                },
                {
                  "key": "vendor",
                  "value": "",
                  "description": "Only shares from this vendor (company id). Additive.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "updatedSince",
                  "value": "",
                  "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "-offeredAt",
                  "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                  "disabled": true
                }
              ]
            },
            "description": "**List platform event shares**\n\nPlatform event promotions vendors offered your company. Filter by status (pending, accepted, declined, expired, vendor_withdrawn), by vendor (`vendor`), by promotion window (`from`, `to`) and by last change (`updatedSince`); order with `sort`. Shares the vendor has not sent yet are never listed. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Shares list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares?status=&vendor=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares"
                  ],
                  "query": [
                    {
                      "key": "status",
                      "value": "",
                      "description": "Comma-separated: pending, accepted, declined, expired, vendor_withdrawn",
                      "disabled": true
                    },
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Only shares from this vendor (company id). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-offeredAt",
                      "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List platform event shares**\n\nPlatform event promotions vendors offered your company. Filter by status (pending, accepted, declined, expired, vendor_withdrawn), by vendor (`vendor`), by promotion window (`from`, `to`) and by last change (`updatedSince`); order with `sort`. Shares the vendor has not sent yet are never listed. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"share_id\": \"93c6a1b2-85ae-40b6-85a9-e79c0bdfdf30\",\n      \"participation_id\": \"162e2a03-6a8d-4152-8b24-8f497b4df8c4\",\n      \"status\": \"pending\",\n      \"participation_status\": \"participating\",\n      \"seller_notes\": \"Happy to take part.\",\n      \"shared_at\": \"2026-11-02T09:30:00Z\",\n      \"responded_at\": \"2026-11-02T09:30:00Z\",\n      \"product_snapshot\": [\n        {\n          \"sku_id\": \"c38a3f89-130c-4dc7-82ed-c5cf5f823584\",\n          \"discount_percent\": 20,\n          \"base_price_cents\": 2450,\n          \"currency_code\": \"EUR\",\n          \"status\": \"included\",\n          \"product_name\": \"Example Game\",\n          \"edition_name\": \"Standard Edition\",\n          \"sku_name\": \"Example Game - Standard Edition\"\n        }\n      ],\n      \"vendor_company_id\": \"acme-games\",\n      \"vendor_company_name\": \"Acme Games\",\n      \"event_id\": \"b06a338f-2935-4b0a-8ff0-da0c9da05eac\",\n      \"event_name\": \"Autumn sale\",\n      \"event_starts_at\": \"2026-11-02T09:30:00Z\",\n      \"event_ends_at\": \"2026-11-02T09:30:00Z\",\n      \"event_submission_deadline\": \"2026-11-02T09:30:00Z\",\n      \"platform_id\": \"7d44ba84-14af-4d5b-80c0-5a146522e486\",\n      \"platform_name\": \"Steam\",\n      \"platform_code\": \"steam\",\n      \"product_count\": 12,\n      \"genre_names\": [\n        \"Example name\"\n      ],\n      \"updated_at\": \"2026-11-02T09:30:00Z\",\n      \"respond_by\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/promotions/shares?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares?status=&vendor=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares"
                  ],
                  "query": [
                    {
                      "key": "status",
                      "value": "",
                      "description": "Comma-separated: pending, accepted, declined, expired, vendor_withdrawn",
                      "disabled": true
                    },
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Only shares from this vendor (company id). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-offeredAt",
                      "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List platform event shares**\n\nPlatform event promotions vendors offered your company. Filter by status (pending, accepted, declined, expired, vendor_withdrawn), by vendor (`vendor`), by promotion window (`from`, `to`) and by last change (`updatedSince`); order with `sort`. Shares the vendor has not sent yet are never listed. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get share detail",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "shares",
                ":shareId"
              ],
              "variable": [
                {
                  "key": "shareId",
                  "value": "{{shareId}}",
                  "description": "Share UUID — from GET /promotions/shares"
                }
              ]
            },
            "description": "**Get share detail**\n\nPlatform event share detail with products (SKU, discount, etc.). Requires seller:promotions:read scope.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Share detail with products",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Get share detail**\n\nPlatform event share detail with products (SKU, discount, etc.). Requires seller:promotions:read scope.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"share_id\": \"05a2a1cc-8292-406d-82d1-d1483d7fb8cb\",\n    \"participation_id\": \"3db44e1e-9a74-4ff8-8d1a-cdf46d4aaf5a\",\n    \"status\": \"pending\",\n    \"participation_status\": \"participating\",\n    \"seller_notes\": \"Happy to take part.\",\n    \"shared_at\": \"2026-11-02T09:30:00Z\",\n    \"responded_at\": \"2026-11-02T09:30:00Z\",\n    \"product_snapshot\": [\n      {\n        \"sku_id\": \"283a2f08-133a-4413-8a2c-f6dc6ba66775\",\n        \"discount_percent\": 20,\n        \"base_price_cents\": 2450,\n        \"currency_code\": \"EUR\",\n        \"status\": \"included\",\n        \"product_name\": \"Example Game\",\n        \"edition_name\": \"Standard Edition\",\n        \"sku_name\": \"Example Game - Standard Edition\"\n      }\n    ],\n    \"vendor_company_id\": \"acme-games\",\n    \"vendor_company_name\": \"Acme Games\",\n    \"event_id\": \"b3e077cf-68c0-45b5-8e67-8ec85dd58eca\",\n    \"event_name\": \"Autumn sale\",\n    \"event_starts_at\": \"2026-11-02T09:30:00Z\",\n    \"event_ends_at\": \"2026-11-02T09:30:00Z\",\n    \"event_submission_deadline\": \"2026-11-02T09:30:00Z\",\n    \"platform_id\": \"199d3a71-f331-44db-894a-55c698e690c5\",\n    \"platform_name\": \"Steam\",\n    \"platform_code\": \"steam\",\n    \"product_count\": 12,\n    \"genre_names\": [\n      \"Example name\"\n    ],\n    \"updated_at\": \"2026-11-02T09:30:00Z\",\n    \"respond_by\": \"2026-11-02T09:30:00Z\",\n    \"products\": [\n      {\n        \"sku_id\": \"1e03e431-499a-43ab-88cd-176201dd2769\",\n        \"sku_code\": \"EXAMPLE-STEAM-WW\",\n        \"product_id\": \"b5efa304-96cf-4955-8f73-7d06691a13f4\",\n        \"product_name\": \"Example Game\",\n        \"edition_name\": \"Standard Edition\",\n        \"key_type_name\": \"Steam key\",\n        \"region_name\": \"Europe\",\n        \"discount_percent\": 20,\n        \"base_price_cents\": 2450,\n        \"currency_code\": \"base_price_cents\",\n        \"price_effect\": \"list_price\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Get share detail**\n\nPlatform event share detail with products (SKU, discount, etc.). Requires seller:promotions:read scope.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"shareId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Accept share",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/accept",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "shares",
                ":shareId",
                "accept"
              ],
              "variable": [
                {
                  "key": "shareId",
                  "value": "{{shareId}}",
                  "description": "Share UUID — from GET /promotions/shares"
                }
              ]
            },
            "description": "**Accept share**\n\nAccept a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Share accepted",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/accept",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "accept"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Accept share**\n\nAccept a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"shareId\": \"4d55896a-c600-45dc-855d-ae4a478683be\",\n    \"status\": \"accepted\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/accept",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "accept"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Accept share**\n\nAccept a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/accept`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"shareId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Decline share",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/decline",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "shares",
                ":shareId",
                "decline"
              ],
              "variable": [
                {
                  "key": "shareId",
                  "value": "{{shareId}}",
                  "description": "Share UUID — from GET /promotions/shares"
                }
              ]
            },
            "description": "**Decline share**\n\nDecline a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Share declined",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/decline",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "decline"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Decline share**\n\nDecline a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"shareId\": \"4c6940fe-041d-4d8c-8ed7-10ee6247dc94\",\n    \"status\": \"declined\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/decline",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "decline"
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Decline share**\n\nDecline a platform event share. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same answer returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/shares/{shareId}/decline`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"shareId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — List received custom deals",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/deals?vendor=&status=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt&vendorCompanyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "deals"
              ],
              "query": [
                {
                  "key": "vendor",
                  "value": "",
                  "description": "Filter by vendor company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Comma-separated: pending, approved, rejected, expired",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "updatedSince",
                  "value": "",
                  "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "-offeredAt",
                  "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                  "disabled": true
                },
                {
                  "key": "vendorCompanyId",
                  "value": "",
                  "description": "Deprecated alias of `vendor`.",
                  "disabled": true
                }
              ]
            },
            "description": "**List received custom deals**\n\nCustom promotions vendors offered your company. Filter by vendor (`vendor`), status (pending, approved, rejected, expired), promotion window (`from`, `to`) and last change (`updatedSince`); order with `sort`. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Deals list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals?vendor=&status=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt&vendorCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals"
                  ],
                  "query": [
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Filter by vendor company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "Comma-separated: pending, approved, rejected, expired",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-offeredAt",
                      "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                      "disabled": true
                    },
                    {
                      "key": "vendorCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `vendor`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List received custom deals**\n\nCustom promotions vendors offered your company. Filter by vendor (`vendor`), status (pending, approved, rejected, expired), promotion window (`from`, `to`) and last change (`updatedSince`); order with `sort`. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"cb4baf6a-94ea-40b5-829c-bc3d8d02b590\",\n      \"promotion_id\": \"3cae451a-f8ae-48cb-8e7e-d8a3542cf9b7\",\n      \"promotion_name\": \"Autumn sale\",\n      \"vendor_company_id\": \"acme-games\",\n      \"vendor_company_name\": \"Acme Games\",\n      \"start_date\": \"2026-11-02T09:30:00Z\",\n      \"end_date\": \"2026-11-02T09:30:00Z\",\n      \"response_deadline\": \"2026-11-02T09:30:00Z\",\n      \"promotion_status\": \"submitted\",\n      \"response_status\": \"pending\",\n      \"response_note\": \"Example text.\",\n      \"responded_at\": \"2026-11-02T09:30:00Z\",\n      \"product_count\": 12,\n      \"created_at\": \"2026-11-02T09:30:00Z\",\n      \"updated_at\": \"2026-11-02T09:30:00Z\",\n      \"respond_by\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/promotions/deals?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals?vendor=&status=&limit=50&cursor=&from=&to=&updatedSince=&sort=-offeredAt&vendorCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals"
                  ],
                  "query": [
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Filter by vendor company ID — slug-safe identifier (alphanumeric, hyphen, underscore), max 32 chars",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "",
                      "description": "Comma-separated: pending, approved, rejected, expired",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only offers whose promotion window ends at or after this instant (ISO 8601, UTC). With `to`, the window overlaps [`from`, `to`]. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only offers whose promotion window starts at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Only offers that changed at or after this instant (`updated_at`), for incremental sync. Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "sort",
                      "value": "-offeredAt",
                      "description": "List order: `offeredAt` is when the vendor sent the offer, `updatedAt` its last change. A leading `-` is newest first. Keep the same `sort` while you follow `nextCursor`. Additive. enum: -offeredAt, offeredAt, -updatedAt, updatedAt",
                      "disabled": true
                    },
                    {
                      "key": "vendorCompanyId",
                      "value": "",
                      "description": "Deprecated alias of `vendor`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List received custom deals**\n\nCustom promotions vendors offered your company. Filter by vendor (`vendor`), status (pending, approved, rejected, expired), promotion window (`from`, `to`) and last change (`updatedSince`); order with `sort`. Requires seller:promotions:read scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get deal detail",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "deals",
                ":responseId"
              ],
              "variable": [
                {
                  "key": "responseId",
                  "value": "{{responseId}}",
                  "description": "Deal response UUID — from GET /promotions/deals"
                }
              ]
            },
            "description": "**Get deal detail**\n\nCustom deal detail with products, which price each discount lowers (`price_effect`) and when it must be answered (`respond_by`). Requires seller:promotions:read scope.\n\nAn unknown deal, or one offered to another company, is `404`. A storage failure is `503` or `504` with `Retry-After` on contract date `2026-12-01` and later; earlier dates answer `500` without the database text.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals/{responseId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Deal detail with products",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals",
                    ":responseId"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Get deal detail**\n\nCustom deal detail with products, which price each discount lowers (`price_effect`) and when it must be answered (`respond_by`). Requires seller:promotions:read scope.\n\nAn unknown deal, or one offered to another company, is `404`. A storage failure is `503` or `504` with `Retry-After` on contract date `2026-12-01` and later; earlier dates answer `500` without the database text.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals/{responseId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"36cbcf4d-0554-464c-86bc-e90ab4dac017\",\n    \"promotion_id\": \"600d7b75-f74b-41ff-80bd-7488d120ad6d\",\n    \"promotion_name\": \"Autumn sale\",\n    \"vendor_company_id\": \"acme-games\",\n    \"vendor_company_name\": \"Acme Games\",\n    \"start_date\": \"2026-11-02T09:30:00Z\",\n    \"end_date\": \"2026-11-02T09:30:00Z\",\n    \"response_deadline\": \"2026-11-02T09:30:00Z\",\n    \"promotion_status\": \"submitted\",\n    \"response_status\": \"pending\",\n    \"response_note\": \"Example text.\",\n    \"responded_at\": \"2026-11-02T09:30:00Z\",\n    \"product_count\": 12,\n    \"created_at\": \"2026-11-02T09:30:00Z\",\n    \"updated_at\": \"2026-11-02T09:30:00Z\",\n    \"respond_by\": \"2026-11-02T09:30:00Z\",\n    \"description\": \"Example text.\",\n    \"message\": \"Example text.\",\n    \"products\": [\n      {\n        \"sku_id\": \"e65109e5-54e3-4e9f-8fbd-a1fe05123124\",\n        \"sku_code\": \"EXAMPLE-STEAM-WW\",\n        \"product_id\": \"ea00be18-eed8-4c66-88bf-cd7a7b48e275\",\n        \"product_name\": \"Example Game\",\n        \"edition_name\": \"Standard Edition\",\n        \"platform_code\": \"steam\",\n        \"platform_name\": \"Steam\",\n        \"key_type_name\": \"Steam key\",\n        \"region_name\": \"Europe\",\n        \"discount_percent\": 20,\n        \"base_price_cents\": 2450,\n        \"currency_code\": \"base_price_cents\",\n        \"price_effect\": \"list_price\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals",
                    ":responseId"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Get deal detail**\n\nCustom deal detail with products, which price each discount lowers (`price_effect`) and when it must be answered (`respond_by`). Requires seller:promotions:read scope.\n\nAn unknown deal, or one offered to another company, is `404`. A storage failure is `503` or `504` with `Retry-After` on contract date `2026-12-01` and later; earlier dates answer `500` without the database text.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/deals/{responseId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"responseId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Respond to deal",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId/respond",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "deals",
                ":responseId",
                "respond"
              ],
              "variable": [
                {
                  "key": "responseId",
                  "value": "{{responseId}}",
                  "description": "Deal response UUID — from GET /promotions/deals"
                }
              ]
            },
            "description": "**Respond to deal**\n\nAccept or decline a custom deal. Body: { decision: 'approved' | 'rejected', note?: string }. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same decision returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/deals/{responseId}/respond`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"decision\": \"approved\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Response recorded",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId/respond",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals",
                    ":responseId",
                    "respond"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Respond to deal**\n\nAccept or decline a custom deal. Body: { decision: 'approved' | 'rejected', note?: string }. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same decision returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/deals/{responseId}/respond`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"decision\": \"approved\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"responseId\": \"7245799e-2856-4ff0-80f9-faf9b4073cc5\",\n    \"status\": \"approved\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/deals/:responseId/respond",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "deals",
                    ":responseId",
                    "respond"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Respond to deal**\n\nAccept or decline a custom deal. Body: { decision: 'approved' | 'rejected', note?: string }. Requires seller:promotions:respond scope. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a repeat without the key is also safe: the same decision returns 200, a different one 409.\n\n**Scopes:** `seller:promotions:respond`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/promotions/deals/{responseId}/respond`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"decision\": \"approved\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"responseId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Promotion share SKU discounts",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/discounts?limit=50&cursor=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "shares",
                ":shareId",
                "discounts"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "shareId",
                  "value": "{{shareId}}",
                  "description": "Share UUID — from GET /promotions/shares"
                }
              ]
            },
            "description": "**Promotion share SKU discounts**\n\nSKU-level discount table for an **accepted** promotion share (`shareId`). `meta.window` carries the event's `startsAt`/`endsAt` and `meta.active` says whether the window is open now (the same predicate that prices settlement). Apply a share's discounts to your storefront only while `meta.active` is `true`.\n\n**Outside the window:** on contract date `2026-12-01` and later the rows are returned before and after the window too, with `meta.active: false`, so you can stage a sale as soon as you accept. Earlier contract dates answer an empty `data` outside the window.\n\n**Not paginated:** the response is the complete discount table of the share. `limit` and `cursor` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}/discounts`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Rows. Outside the window: rows with `meta.active: false` on contract date `2026-12-01` and later; empty `data` on earlier dates.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/discounts?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "discounts"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Promotion share SKU discounts**\n\nSKU-level discount table for an **accepted** promotion share (`shareId`). `meta.window` carries the event's `startsAt`/`endsAt` and `meta.active` says whether the window is open now (the same predicate that prices settlement). Apply a share's discounts to your storefront only while `meta.active` is `true`.\n\n**Outside the window:** on contract date `2026-12-01` and later the rows are returned before and after the window too, with `meta.active: false`, so you can stage a sale as soon as you accept. Earlier contract dates answer an empty `data` outside the window.\n\n**Not paginated:** the response is the complete discount table of the share. `limit` and `cursor` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}/discounts`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"productId\": \"974bfe5b-1439-4ed3-8e31-361b217838e5\",\n      \"sku\": \"EXAMPLE-STEAM-WW\",\n      \"discountPct\": 12,\n      \"skuId\": \"cc719e53-780f-452c-87dc-21dcb2e8e19e\",\n      \"priceEffect\": \"list_price\"\n    }\n  ],\n  \"meta\": {\n    \"window\": {\n      \"startsAt\": \"2026-11-02T09:30:00Z\",\n      \"endsAt\": \"2026-11-02T09:30:00Z\"\n    },\n    \"active\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/shares/:shareId/discounts?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "shares",
                    ":shareId",
                    "discounts"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "shareId",
                      "value": "{{shareId}}",
                      "description": "Share UUID — from GET /promotions/shares"
                    }
                  ]
                },
                "description": "**Promotion share SKU discounts**\n\nSKU-level discount table for an **accepted** promotion share (`shareId`). `meta.window` carries the event's `startsAt`/`endsAt` and `meta.active` says whether the window is open now (the same predicate that prices settlement). Apply a share's discounts to your storefront only while `meta.active` is `true`.\n\n**Outside the window:** on contract date `2026-12-01` and later the rows are returned before and after the window too, with `meta.active: false`, so you can stage a sale as soon as you accept. Earlier contract dates answer an empty `data` outside the window.\n\n**Not paginated:** the response is the complete discount table of the share. `limit` and `cursor` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/shares/{shareId}/discounts`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"shareId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List live and upcoming promotion windows",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/promotions/calendar?from=&to=&skuId=&productId=&sourceId=&vendor=&window=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "promotions",
                "calendar"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Only windows that end at or after this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Only windows that start at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "skuId",
                  "value": "",
                  "description": "Comma-separated SKU ids (at most 50). Additive.",
                  "disabled": true
                },
                {
                  "key": "productId",
                  "value": "",
                  "description": "Comma-separated catalog product ids (at most 50). Additive.",
                  "disabled": true
                },
                {
                  "key": "sourceId",
                  "value": "",
                  "description": "Comma-separated share ids or deal response ids (at most 50). Additive.",
                  "disabled": true
                },
                {
                  "key": "vendor",
                  "value": "",
                  "description": "Only promotions of this vendor (company id). Additive.",
                  "disabled": true
                },
                {
                  "key": "window",
                  "value": "",
                  "description": "Comma-separated: `live`, `upcoming`, `ended`. Default `live,upcoming`. `ended` returns windows that closed since `from`, or in the last 90 days without it. Additive.",
                  "disabled": true
                }
              ]
            },
            "description": "**List live and upcoming promotion windows**\n\nAccepted shares and approved deals by SKU with their window and `priceEffect` (`list_price`, `settlement_price`, or `both`). Live and upcoming windows by default; filter by window (`from`, `to`, `window`), SKU, product, offer (`sourceId`) or vendor (`vendor`). `basePriceCents` on `/products/{id}/pricing` stays the undiscounted list price; the catalogue promotion fields beside it (`listPromo`, `advertisedPriceCents`, `promo`, `promotions`) say what a promotion does to it. Settlement-affecting windows change preview/commit unit price. Requires seller:promotions:read.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/calendar`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Promotion calendar",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/calendar?from=&to=&skuId=&productId=&sourceId=&vendor=&window=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "calendar"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only windows that end at or after this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only windows that start at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "skuId",
                      "value": "",
                      "description": "Comma-separated SKU ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "productId",
                      "value": "",
                      "description": "Comma-separated catalog product ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "sourceId",
                      "value": "",
                      "description": "Comma-separated share ids or deal response ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Only promotions of this vendor (company id). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "window",
                      "value": "",
                      "description": "Comma-separated: `live`, `upcoming`, `ended`. Default `live,upcoming`. `ended` returns windows that closed since `from`, or in the last 90 days without it. Additive.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List live and upcoming promotion windows**\n\nAccepted shares and approved deals by SKU with their window and `priceEffect` (`list_price`, `settlement_price`, or `both`). Live and upcoming windows by default; filter by window (`from`, `to`, `window`), SKU, product, offer (`sourceId`) or vendor (`vendor`). `basePriceCents` on `/products/{id}/pricing` stays the undiscounted list price; the catalogue promotion fields beside it (`listPromo`, `advertisedPriceCents`, `promo`, `promotions`) say what a promotion does to it. Settlement-affecting windows change preview/commit unit price. Requires seller:promotions:read.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/calendar`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"sourceType\": \"event\",\n      \"sourceId\": \"227a1a5d-66b5-4389-8d0f-128176b13323\",\n      \"skuId\": \"da92ffcd-54f6-441f-8adf-b525c2a6aaeb\",\n      \"discountPercent\": 20,\n      \"priceEffect\": \"list_price\",\n      \"startDate\": \"2026-11-02T09:30:00Z\",\n      \"endDate\": \"2026-11-02T09:30:00Z\",\n      \"window\": \"live\",\n      \"vendorCompanyId\": \"acme-games\",\n      \"name\": \"Example Game\",\n      \"productId\": \"aeaa685f-5ae8-4100-8e8d-f6e372e542ee\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/promotions/calendar?from=&to=&skuId=&productId=&sourceId=&vendor=&window=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "promotions",
                    "calendar"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Only windows that end at or after this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Only windows that start at or before this instant (ISO 8601, UTC). Additive. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "skuId",
                      "value": "",
                      "description": "Comma-separated SKU ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "productId",
                      "value": "",
                      "description": "Comma-separated catalog product ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "sourceId",
                      "value": "",
                      "description": "Comma-separated share ids or deal response ids (at most 50). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "vendor",
                      "value": "",
                      "description": "Only promotions of this vendor (company id). Additive.",
                      "disabled": true
                    },
                    {
                      "key": "window",
                      "value": "",
                      "description": "Comma-separated: `live`, `upcoming`, `ended`. Default `live,upcoming`. `ended` returns windows that closed since `from`, or in the last 90 days without it. Additive.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List live and upcoming promotion windows**\n\nAccepted shares and approved deals by SKU with their window and `priceEffect` (`list_price`, `settlement_price`, or `both`). Live and upcoming windows by default; filter by window (`from`, `to`, `window`), SKU, product, offer (`sourceId`) or vendor (`vendor`). `basePriceCents` on `/products/{id}/pricing` stays the undiscounted list price; the catalogue promotion fields beside it (`listPromo`, `advertisedPriceCents`, `promo`, `promotions`) say what a promotion does to it. Settlement-affecting windows change preview/commit unit price. Requires seller:promotions:read.\n\n**Scopes:** `seller:promotions:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/promotions/calendar`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Webhooks",
      "description": "Webhook endpoint lifecycle, test deliveries, re-enable after circuit disable, delivery history and retries. Scope: `seller:webhooks:read` / `seller:webhooks:write`.",
      "item": [
        {
          "name": "GET — List webhook event types",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/event-types",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                "event-types"
              ]
            },
            "description": "**List webhook event types**\n\nCatalog of webhook event names and short descriptions for subscription discovery. Canonical list: GET /api/seller/v1/webhooks/event-types.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/event-types`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Webhook event type catalog",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/event-types",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    "event-types"
                  ]
                },
                "description": "**List webhook event types**\n\nCatalog of webhook event names and short descriptions for subscription discovery. Canonical list: GET /api/seller/v1/webhooks/event-types.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/event-types`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"name\": \"test.ping\",\n      \"description\": \"Example text.\"\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/event-types",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    "event-types"
                  ]
                },
                "description": "**List webhook event types**\n\nCatalog of webhook event names and short descriptions for subscription discovery. Canonical list: GET /api/seller/v1/webhooks/event-types.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/event-types`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List webhook endpoints",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks?limit=50&cursor=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                }
              ]
            },
            "description": "**List webhook endpoints**\n\nList registered webhook endpoints for your company.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Webhook endpoints list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List webhook endpoints**\n\nList registered webhook endpoints for your company.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"c06fad5d-e496-48e3-8405-537a2b458aef\",\n      \"url\": \"https://store.example.com/webhooks/avrix\",\n      \"events\": [\n        \"order.fulfilled\"\n      ],\n      \"status\": \"active\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"bufferedDeliveries\": 1,\n      \"bufferCapacity\": 12\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/webhooks?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List webhook endpoints**\n\nList registered webhook endpoints for your company.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Create webhook endpoint",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks"
              ]
            },
            "description": "**Create webhook endpoint**\n\nRegister a webhook endpoint. Returns the signing secret ONCE - store it securely.\n\n**Limit:** on contract date `2026-12-01` and later a company registers at most 16 endpoints (active and disabled; for a sandbox key, per key). The seventeenth answers **409** `WEBHOOK_ENDPOINT_LIMIT_REACHED` with `details.limit` and `details.current`. Endpoints that already exist above the limit keep working, and earlier dates have no limit. One endpoint can take many events: use wildcards (`*`, `order.*`).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://merchant.example/webhooks/avrix\",\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"test.ping\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Webhook created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks"
                  ]
                },
                "description": "**Create webhook endpoint**\n\nRegister a webhook endpoint. Returns the signing secret ONCE - store it securely.\n\n**Limit:** on contract date `2026-12-01` and later a company registers at most 16 endpoints (active and disabled; for a sandbox key, per key). The seventeenth answers **409** `WEBHOOK_ENDPOINT_LIMIT_REACHED` with `details.limit` and `details.current`. Endpoints that already exist above the limit keep working, and earlier dates have no limit. One endpoint can take many events: use wildcards (`*`, `order.*`).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"url\": \"https://merchant.example/webhooks/avrix\",\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"test.ping\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"002873e6-76ce-45cc-8caf-b522a28632df\",\n    \"url\": \"https://store.example.com/webhooks/avrix\",\n    \"events\": [\n      \"order.fulfilled\"\n    ],\n    \"secret\": \"whsec_8f2c1d0e9b7a6c5d4e3f2a1b0c9d8e7f\",\n    \"deliveryProbe\": {\n      \"reachable\": true,\n      \"statusCode\": 200\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks"
                  ]
                },
                "description": "**Create webhook endpoint**\n\nRegister a webhook endpoint. Returns the signing secret ONCE - store it securely.\n\n**Limit:** on contract date `2026-12-01` and later a company registers at most 16 endpoints (active and disabled; for a sandbox key, per key). The seventeenth answers **409** `WEBHOOK_ENDPOINT_LIMIT_REACHED` with `details.limit` and `details.current`. Endpoints that already exist above the limit keep working, and earlier dates have no limit. One endpoint can take many events: use wildcards (`*`, `order.*`).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"url\": \"https://merchant.example/webhooks/avrix\",\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"test.ping\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Get webhook endpoint",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Get webhook endpoint**\n\nOne webhook endpoint, in the shape `GET /webhooks` lists it: its subscription, status, delivery health (`failing`, `lastSuccessAt`, `lastFailureAt`, `consecutiveFailedAttempts`) and queue (`pendingDeliveries`, `bufferedDeliveries`). The signing secret is never returned.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The endpoint",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Get webhook endpoint**\n\nOne webhook endpoint, in the shape `GET /webhooks` lists it: its subscription, status, delivery health (`failing`, `lastSuccessAt`, `lastFailureAt`, `consecutiveFailedAttempts`) and queue (`pendingDeliveries`, `bufferedDeliveries`). The signing secret is never returned.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"e3856f36-ce7e-4d8b-81fa-a50411164874\",\n    \"url\": \"https://store.example.com/webhooks/avrix\",\n    \"events\": [\n      \"order.fulfilled\"\n    ],\n    \"status\": \"active\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"bufferedDeliveries\": 1,\n    \"bufferCapacity\": 12,\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"failing\": false,\n    \"failingSince\": \"2026-11-02T09:30:00Z\",\n    \"lastSuccessAt\": \"2026-11-02T09:30:00Z\",\n    \"consecutiveFailedAttempts\": 1,\n    \"pendingDeliveries\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Get webhook endpoint**\n\nOne webhook endpoint, in the shape `GET /webhooks` lists it: its subscription, status, delivery health (`failing`, `lastSuccessAt`, `lastFailureAt`, `consecutiveFailedAttempts`) and queue (`pendingDeliveries`, `bufferedDeliveries`). The signing secret is never returned.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "PATCH — Update webhook endpoint",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Update webhook endpoint**\n\nUpdate URL and/or events, or rotate the signing secret (`rotateSecret: true`). **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. A retried rotation with the same key does not rotate again: it answers with the secret the first call minted.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"order.reserved\",\n    \"test.ping\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Updated",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Update webhook endpoint**\n\nUpdate URL and/or events, or rotate the signing secret (`rotateSecret: true`). **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. A retried rotation with the same key does not rotate again: it answers with the secret the first call minted.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"order.reserved\",\n    \"test.ping\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"8267ba06-36b3-480e-81a2-c171876c7ed5\",\n    \"url\": \"https://store.example.com/webhooks/avrix\",\n    \"events\": [\n      \"order.fulfilled\"\n    ],\n    \"secretRedacted\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Update webhook endpoint**\n\nUpdate URL and/or events, or rotate the signing secret (`rotateSecret: true`). **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. A retried rotation with the same key does not rotate again: it answers with the secret the first call minted.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `PATCH /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"events\": [\n    \"order.fulfilled\",\n    \"order.failed\",\n    \"order.reserved\",\n    \"test.ping\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "DELETE — Delete webhook endpoint",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Delete webhook endpoint**\n\nRemove a webhook endpoint. Stops sending events.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "204 Webhook deleted. The endpoint stops receiving and leaves the listing; its delivery history stays readable on GET /events and GET /webhooks/{id}/deliveries (meta.endpointDeleted).",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Delete webhook endpoint**\n\nRemove a webhook endpoint. Stops sending events.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "No Content",
              "code": 204,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Delete webhook endpoint**\n\nRemove a webhook endpoint. Stops sending events.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/webhooks/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Send test webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/test",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Send test webhook**\n\nQueues a signed test delivery to the endpoint and delivers it through the normal signing and delivery pipeline. With no body (or `{}`) it sends `test.ping`, which verifies the URL and HMAC handling.\n\n**Sandbox keys** can also send any Seller API event type (`eventType`) with a contract-valid sample payload, and turn the delivery into a receiver challenge (`challenge`): mis-signed, ten minutes stale, delivered twice with one `eventId`, or signed with the previous secret only. Every such delivery carries a top-level `testEvent` object (`testRunId`, `challenge`) so your handler can tell it from real traffic. The certification report (`GET /sandbox/certification`) reads the outcomes.\n\n**Production keys** can send `test.ping` only; a different `eventType` or any `challenge` answers **422** `SANDBOX_KEY_REQUIRED`. An unknown `eventType` answers **422** `VALIDATION_FAILED`.\n\nThe body is strict: unknown fields answer **422** `VALIDATION_FAILED`. `X-Avrix-Sandbox-Simulate: webhook_delay_30s` delays the first attempt by 30 seconds on sandbox keys.\n\n**Disabled endpoints:** on contract date `2026-12-01` and later a test send to a disabled endpoint (paused, or disabled by the circuit breaker) is sent once, so you can check a fix before re-enabling. It does not re-enable the endpoint, is not retried, and does not count toward the endpoint's health. Earlier dates answer **400** `BAD_REQUEST` (\"Webhook endpoint is not active\").\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/test`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "202 Test delivery queued",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/test",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "test"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Send test webhook**\n\nQueues a signed test delivery to the endpoint and delivers it through the normal signing and delivery pipeline. With no body (or `{}`) it sends `test.ping`, which verifies the URL and HMAC handling.\n\n**Sandbox keys** can also send any Seller API event type (`eventType`) with a contract-valid sample payload, and turn the delivery into a receiver challenge (`challenge`): mis-signed, ten minutes stale, delivered twice with one `eventId`, or signed with the previous secret only. Every such delivery carries a top-level `testEvent` object (`testRunId`, `challenge`) so your handler can tell it from real traffic. The certification report (`GET /sandbox/certification`) reads the outcomes.\n\n**Production keys** can send `test.ping` only; a different `eventType` or any `challenge` answers **422** `SANDBOX_KEY_REQUIRED`. An unknown `eventType` answers **422** `VALIDATION_FAILED`.\n\nThe body is strict: unknown fields answer **422** `VALIDATION_FAILED`. `X-Avrix-Sandbox-Simulate: webhook_delay_30s` delays the first attempt by 30 seconds on sandbox keys.\n\n**Disabled endpoints:** on contract date `2026-12-01` and later a test send to a disabled endpoint (paused, or disabled by the circuit breaker) is sent once, so you can check a fix before re-enabling. It does not re-enable the endpoint, is not retried, and does not count toward the endpoint's health. Earlier dates answer **400** `BAD_REQUEST` (\"Webhook endpoint is not active\").\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/test`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"deliveryId\": \"8d4e2b1a-6c3f-4a5e-9b7d-1f2e3c4d5a6b\",\n    \"deliveryIds\": [\n      \"8d4e2b1a-6c3f-4a5e-9b7d-1f2e3c4d5a6b\"\n    ],\n    \"eventId\": \"evt_1760256600000_3c1d9a7b2e4f6a80\",\n    \"eventType\": \"order.fulfilled\",\n    \"challenge\": \"invalid_signature\",\n    \"testRunId\": \"4b8e1f2a-9c3d-4e5f-8a6b-7c9d0e1f2a3b\",\n    \"message\": \"Test delivery queued. Check GET .../webhooks/:id/deliveries for status.\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail or misbehave on purpose so you can rehearse your recovery. Each operation honours the values listed for it below. On contract date `2026-12-01` or later, a value this operation does not honour, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, with `details.honoured` listing the values it accepts; on earlier dates such a value is ignored and the call runs normally, except that `POST /orders` answers 422 `SANDBOX_SCENARIO_UNAVAILABLE` for a scenario that belongs to another operation.\n\n**Faults returned before any work is done** (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`): `rate_limit` (429, `Retry-After: 2`), `hot_path_timeout` (504 `HOT_PATH_TIMEOUT`), `key_decrypt_failed` (503 `KEY_DECRYPT_FAILED`), `billing_record_failed` (503 `BILLING_RECORD_FAILED`), `internal_error` (500), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`), `idempotency_in_flight` (409 `IDEMPOTENCY_REQUEST_IN_FLIGHT`). `POST /orders/hold` and `POST /webhooks/{id}/test` honour `rate_limit`, `internal_error` and `service_unavailable` from this group (`rate_limit` only before contract date `2026-12-01`).\n\n**Delayed webhook** (`POST /orders`, `POST /webhooks/{id}/test`): `webhook_delay_30s` delivers the resulting webhook 30 seconds late.\n\n**Buyer verification**, contract date `2026-12-01` and later; ignored on earlier dates (`POST /orders`, `POST /orders/bulk`, `POST /orders/commit`, `POST /keys/pull`, `POST /orders/hold`, `POST /orders/preview`, `POST /orders/reserve`): `buyer_verification_required` makes this one call behave as if the vendor required buyer network confirmation, so it answers 422 `CONSUMER_GEO_ATTEST_REQUIRED` until you send a completed `consumerGeoAttestId` (mint one with `POST /geo/attest`, read it back with `GET /geo/attest/{attestId}`).\n\n**Stateful scenarios**, which run only in your store's isolated sandbox environment and answer 422 `SANDBOX_SCENARIO_UNAVAILABLE` on the shared sandbox: `timeout_then_success`, `error_after_commit` and `webhook_delay_duplicate` on `POST /orders`; `partial_cart` on `POST /orders/bulk`; `sold_out_after_hold` on `POST /orders/hold`. See `https://docs.avrix.io/seller-api/sandbox`.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/test",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "test"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Send test webhook**\n\nQueues a signed test delivery to the endpoint and delivers it through the normal signing and delivery pipeline. With no body (or `{}`) it sends `test.ping`, which verifies the URL and HMAC handling.\n\n**Sandbox keys** can also send any Seller API event type (`eventType`) with a contract-valid sample payload, and turn the delivery into a receiver challenge (`challenge`): mis-signed, ten minutes stale, delivered twice with one `eventId`, or signed with the previous secret only. Every such delivery carries a top-level `testEvent` object (`testRunId`, `challenge`) so your handler can tell it from real traffic. The certification report (`GET /sandbox/certification`) reads the outcomes.\n\n**Production keys** can send `test.ping` only; a different `eventType` or any `challenge` answers **422** `SANDBOX_KEY_REQUIRED`. An unknown `eventType` answers **422** `VALIDATION_FAILED`.\n\nThe body is strict: unknown fields answer **422** `VALIDATION_FAILED`. `X-Avrix-Sandbox-Simulate: webhook_delay_30s` delays the first attempt by 30 seconds on sandbox keys.\n\n**Disabled endpoints:** on contract date `2026-12-01` and later a test send to a disabled endpoint (paused, or disabled by the circuit breaker) is sent once, so you can check a fix before re-enabling. It does not re-enable the endpoint, is not retried, and does not count toward the endpoint's health. Earlier dates answer **400** `BAD_REQUEST` (\"Webhook endpoint is not active\").\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/test`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Re-enable webhook endpoint",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/enable",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "enable"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Re-enable webhook endpoint**\n\nSets status to active after a circuit-breaker disable or a pause (`POST /webhooks/{id}/disable`); resets failure counters and the `failing` signal.\n\n**Buffered events:** deliveries queued while the endpoint was disabled are flushed on re-enable (`flushedBufferedDeliveries` reports the count). To resume without the backlog, send `replayFrom`: only buffered events created at or after it are sent, older ones are closed as failed with `lastError` `skipped_on_enable` (`skippedBufferedDeliveries`) and stay in the delivery log, where retry and replay can still send them. Without a body every buffered event is sent, as before.\n\n**Body:** optional. An invalid or future `replayFrom` answers **422** `VALIDATION_FAILED`. On contract date `2026-12-01` and later a body that is not a JSON object also answers **422**; earlier dates ignore it. Unknown fields are ignored.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/enable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"replayFrom\": \"2026-11-13T09:00:00Z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Re-enabled. The endpoint in its `GET /webhooks/{id}` shape, plus the buffer outcome.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/enable",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "enable"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Re-enable webhook endpoint**\n\nSets status to active after a circuit-breaker disable or a pause (`POST /webhooks/{id}/disable`); resets failure counters and the `failing` signal.\n\n**Buffered events:** deliveries queued while the endpoint was disabled are flushed on re-enable (`flushedBufferedDeliveries` reports the count). To resume without the backlog, send `replayFrom`: only buffered events created at or after it are sent, older ones are closed as failed with `lastError` `skipped_on_enable` (`skippedBufferedDeliveries`) and stay in the delivery log, where retry and replay can still send them. Without a body every buffered event is sent, as before.\n\n**Body:** optional. An invalid or future `replayFrom` answers **422** `VALIDATION_FAILED`. On contract date `2026-12-01` and later a body that is not a JSON object also answers **422**; earlier dates ignore it. Unknown fields are ignored.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/enable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"replayFrom\": \"2026-11-13T09:00:00Z\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"b1ec8da3-4525-4382-87c7-1675ceddfa43\",\n    \"status\": \"active\",\n    \"message\": \"Example text.\",\n    \"flushedBufferedDeliveries\": 1\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/enable",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "enable"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Re-enable webhook endpoint**\n\nSets status to active after a circuit-breaker disable or a pause (`POST /webhooks/{id}/disable`); resets failure counters and the `failing` signal.\n\n**Buffered events:** deliveries queued while the endpoint was disabled are flushed on re-enable (`flushedBufferedDeliveries` reports the count). To resume without the backlog, send `replayFrom`: only buffered events created at or after it are sent, older ones are closed as failed with `lastError` `skipped_on_enable` (`skippedBufferedDeliveries`) and stay in the delivery log, where retry and replay can still send them. Without a body every buffered event is sent, as before.\n\n**Body:** optional. An invalid or future `replayFrom` answers **422** `VALIDATION_FAILED`. On contract date `2026-12-01` and later a body that is not a JSON object also answers **422**; earlier dates ignore it. Unknown fields are ignored.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/enable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"replayFrom\": \"2026-11-13T09:00:00Z\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Pause webhook endpoint",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/disable",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "disable"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Pause webhook endpoint**\n\nPauses an active endpoint: nothing is sent to it until `POST /webhooks/{id}/enable`. Events that happen meanwhile are buffered as after a circuit-breaker disable (up to `bufferCapacity`), and `GET /events` keeps every event. `disabledReason` is `manual`; a pause raises no disabled alert. Pausing a disabled endpoint changes nothing (`alreadyDisabled`). Resume with `POST /webhooks/{id}/enable`, optionally with `replayFrom` to skip the backlog; check your receiver first with `POST /webhooks/{id}/test` (contract date `2026-12-01` and later).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/disable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Paused (or already disabled)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/disable",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "disable"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Pause webhook endpoint**\n\nPauses an active endpoint: nothing is sent to it until `POST /webhooks/{id}/enable`. Events that happen meanwhile are buffered as after a circuit-breaker disable (up to `bufferCapacity`), and `GET /events` keeps every event. `disabledReason` is `manual`; a pause raises no disabled alert. Pausing a disabled endpoint changes nothing (`alreadyDisabled`). Resume with `POST /webhooks/{id}/enable`, optionally with `replayFrom` to skip the backlog; check your receiver first with `POST /webhooks/{id}/test` (contract date `2026-12-01` and later).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/disable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"2731f87a-b6f0-442f-832f-a94011003f83\",\n    \"url\": \"https://store.example.com/webhooks/avrix\",\n    \"events\": [\n      \"order.fulfilled\"\n    ],\n    \"status\": \"active\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"bufferedDeliveries\": 1,\n    \"bufferCapacity\": 12,\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"failing\": false,\n    \"failingSince\": \"2026-11-02T09:30:00Z\",\n    \"lastSuccessAt\": \"2026-11-02T09:30:00Z\",\n    \"consecutiveFailedAttempts\": 1,\n    \"pendingDeliveries\": 1,\n    \"message\": \"Example text.\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/disable",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "disable"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Pause webhook endpoint**\n\nPauses an active endpoint: nothing is sent to it until `POST /webhooks/{id}/enable`. Events that happen meanwhile are buffered as after a circuit-breaker disable (up to `bufferCapacity`), and `GET /events` keeps every event. `disabledReason` is `manual`; a pause raises no disabled alert. Pausing a disabled endpoint changes nothing (`alreadyDisabled`). Resume with `POST /webhooks/{id}/enable`, optionally with `replayFrom` to skip the backlog; check your receiver first with `POST /webhooks/{id}/test` (contract date `2026-12-01` and later).\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/disable`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Get webhook delivery",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "deliveries",
                ":deliveryId"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                },
                {
                  "key": "deliveryId",
                  "value": "{{deliveryId}}",
                  "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                }
              ]
            },
            "description": "**Get webhook delivery**\n\nOne delivery in full: the body your endpoint received, the identifying headers, your endpoint's last answer and one entry per attempt (status, a bounded and redacted excerpt of the answer, the classified error, the duration). Readable after the endpoint is deleted (`meta.endpointDeleted`). Deliveries are kept 30 days.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The delivery",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    ":deliveryId"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    },
                    {
                      "key": "deliveryId",
                      "value": "{{deliveryId}}",
                      "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                    }
                  ]
                },
                "description": "**Get webhook delivery**\n\nOne delivery in full: the body your endpoint received, the identifying headers, your endpoint's last answer and one entry per attempt (status, a bounded and redacted excerpt of the answer, the classified error, the duration). Readable after the endpoint is deleted (`meta.endpointDeleted`). Deliveries are kept 30 days.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"4e6ba46e-b94b-4c2c-8068-ad176df86e6a\",\n    \"endpointId\": \"ac262fc7-fe00-498b-821d-2050094f64d9\",\n    \"eventId\": \"f47b9cd1-e808-459d-8f50-382bfb30ec26\",\n    \"eventType\": \"order.fulfilled\",\n    \"eventLogId\": \"12229ce7-4f5c-4079-83ea-05787b30a410\",\n    \"status\": \"active\",\n    \"attempts\": 1,\n    \"responseStatus\": 200,\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"lastAttemptAt\": \"2026-11-02T09:30:00Z\",\n    \"nextRetryAt\": \"2026-11-02T09:30:00Z\",\n    \"testEvent\": true,\n    \"body\": {},\n    \"headers\": {\n      \"example\": \"example_headers\"\n    },\n    \"responseBodyExcerpt\": \"example_responsebodyexcerpt\",\n    \"attemptHistory\": [\n      {\n        \"attemptNumber\": 1,\n        \"attemptedAt\": \"2026-11-02T09:30:00Z\",\n        \"outcome\": \"succeeded\",\n        \"responseStatus\": 200,\n        \"responseBodyExcerpt\": \"example_responsebodyexcerpt\",\n        \"durationMs\": 1\n      }\n    ]\n  },\n  \"meta\": {\n    \"endpointDeleted\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    ":deliveryId"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    },
                    {
                      "key": "deliveryId",
                      "value": "{{deliveryId}}",
                      "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                    }
                  ]
                },
                "description": "**Get webhook delivery**\n\nOne delivery in full: the body your endpoint received, the identifying headers, your endpoint's last answer and one entry per attempt (status, a bounded and redacted excerpt of the answer, the classified error, the duration). Readable after the endpoint is deleted (`meta.endpointDeleted`). Deliveries are kept 30 days.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\",\"deliveryId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Retry failed webhook delivery",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId/retry",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "deliveries",
                ":deliveryId",
                "retry"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                },
                {
                  "key": "deliveryId",
                  "value": "{{deliveryId}}",
                  "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                }
              ]
            },
            "description": "**Retry failed webhook delivery**\n\nRe-queues a failed delivery with attempts reset.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}/retry`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "202 Delivery re-queued",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId/retry",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    ":deliveryId",
                    "retry"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    },
                    {
                      "key": "deliveryId",
                      "value": "{{deliveryId}}",
                      "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                    }
                  ]
                },
                "description": "**Retry failed webhook delivery**\n\nRe-queues a failed delivery with attempts reset.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}/retry`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"deliveryId\": \"a1dcd313-4d44-4ff9-8ef6-87320fc2aef8\",\n    \"message\": \"Example text.\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/:deliveryId/retry",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    ":deliveryId",
                    "retry"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    },
                    {
                      "key": "deliveryId",
                      "value": "{{deliveryId}}",
                      "description": "Webhook delivery UUID — from GET /webhooks/{id}/deliveries"
                    }
                  ]
                },
                "description": "**Retry failed webhook delivery**\n\nRe-queues a failed delivery with attempts reset.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/{deliveryId}/retry`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\",\"deliveryId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Bulk replay webhook deliveries (Phase 3.3)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/replay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "deliveries",
                "replay"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**Bulk replay webhook deliveries (Phase 3.3)**\n\nRe-enqueues a window of past deliveries for an endpoint. Each replay inserts a **new** `event_id` (global uniqueness); the outbound JSON duplicates the original envelope and adds **`replay.sourceDeliveryId`** and **`replay.originalEventId`** so receivers can correlate with idempotency keyed on `event_id` / `X-Avrix-Event-Id`. Use to recover from partner-side outages without manual ticket-driven resyncs. Window is capped at 7 days back; up to 1000 deliveries per call. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a replay never clones a delivery that is itself a replay (its payload carries `replay`) or a test delivery, so replaying the same window twice does not multiply deliveries; earlier contract dates clone every matching delivery.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/replay`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"since\": \"2026-08-01T00:00:00.000Z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "202 Replay enqueued",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/replay",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    "replay"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Bulk replay webhook deliveries (Phase 3.3)**\n\nRe-enqueues a window of past deliveries for an endpoint. Each replay inserts a **new** `event_id` (global uniqueness); the outbound JSON duplicates the original envelope and adds **`replay.sourceDeliveryId`** and **`replay.originalEventId`** so receivers can correlate with idempotency keyed on `event_id` / `X-Avrix-Event-Id`. Use to recover from partner-side outages without manual ticket-driven resyncs. Window is capped at 7 days back; up to 1000 deliveries per call. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a replay never clones a delivery that is itself a replay (its payload carries `replay`) or a test delivery, so replaying the same window twice does not multiply deliveries; earlier contract dates clone every matching delivery.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/replay`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"since\": \"2026-08-01T00:00:00.000Z\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"enqueued\": 1,\n    \"deliveryIds\": [\n      \"a8275cd5-d398-4d42-8778-546b0c2a84ef\"\n    ],\n    \"sourceDeliveryIds\": [\n      \"e6b168e8-0c03-4de7-8d81-b65988b416a6\"\n    ],\n    \"hasMore\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries/replay",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries",
                    "replay"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**Bulk replay webhook deliveries (Phase 3.3)**\n\nRe-enqueues a window of past deliveries for an endpoint. Each replay inserts a **new** `event_id` (global uniqueness); the outbound JSON duplicates the original envelope and adds **`replay.sourceDeliveryId`** and **`replay.originalEventId`** so receivers can correlate with idempotency keyed on `event_id` / `X-Avrix-Event-Id`. Use to recover from partner-side outages without manual ticket-driven resyncs. Window is capped at 7 days back; up to 1000 deliveries per call. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. On contract date `2026-12-01` and later a replay never clones a delivery that is itself a replay (its payload carries `replay`) or a test delivery, so replaying the same window twice does not multiply deliveries; earlier contract dates clone every matching delivery.\n\n**Scopes:** `seller:webhooks:write`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/webhooks/{id}/deliveries/replay`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"since\": \"2026-08-01T00:00:00.000Z\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — List webhook deliveries",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries?limit=50&status=pending&cursor=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                ":id",
                "deliveries"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "pending",
                  "description": "Return only deliveries in this state. enum: pending, succeeded, failed",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{webhookId}}",
                  "description": "Webhook endpoint UUID — from GET /webhooks"
                }
              ]
            },
            "description": "**List webhook deliveries**\n\nList delivery status for a webhook endpoint. Use for debugging failed deliveries. Filter by status (pending, succeeded, failed).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page. The history pages past the newest 100 deliveries; earlier releases stopped there.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Delivery list",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries?limit=50&status=pending&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Return only deliveries in this state. enum: pending, succeeded, failed",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**List webhook deliveries**\n\nList delivery status for a webhook endpoint. Use for debugging failed deliveries. Filter by status (pending, succeeded, failed).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page. The history pages past the newest 100 deliveries; earlier releases stopped there.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"92a9bb64-8dab-4140-817d-5b8bb6518b38\",\n      \"endpointId\": \"5f76e184-de23-4fa6-8b8f-8e2a3ac60ec0\",\n      \"eventId\": \"03e4f2bb-ba20-494c-841e-c6e02fd813b0\",\n      \"eventType\": \"order.fulfilled\",\n      \"status\": \"succeeded\",\n      \"attempts\": 1,\n      \"responseStatus\": 200,\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"lastAttemptAt\": \"2026-11-02T09:30:00Z\",\n      \"nextRetryAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"endpointDeleted\": true,\n    \"limit\": 50,\n    \"count\": 12,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/webhooks/10530c96-45a3-4e5e-83cc-3921dd4bb0ab/deliveries?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/:id/deliveries?limit=50&status=pending&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    ":id",
                    "deliveries"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Return only deliveries in this state. enum: pending, succeeded, failed",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{webhookId}}",
                      "description": "Webhook endpoint UUID — from GET /webhooks"
                    }
                  ]
                },
                "description": "**List webhook deliveries**\n\nList delivery status for a webhook endpoint. Use for debugging failed deliveries. Filter by status (pending, succeeded, failed).\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page. The history pages past the newest 100 deliveries; earlier releases stopped there.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `webhooks-mgmt`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/webhooks/{id}/deliveries`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"webhookId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Webhook egress identity",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/webhooks/egress-ips",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "webhooks",
                "egress-ips"
              ]
            },
            "description": "**Webhook egress identity**\n\nThe source-IP identity of webhook deliveries, for firewall teams. Key-free. When `pinned` is false (the current default — egress is not pinned on this infrastructure), do NOT build source-IP allowlists; signature verification is the authoritative control. When pinned, address changes are announced in the changelog at least 14 days ahead (the response's `policy` text says the same).\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/webhooks/egress-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 Egress identity",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/egress-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    "egress-ips"
                  ]
                },
                "description": "**Webhook egress identity**\n\nThe source-IP identity of webhook deliveries, for firewall teams. Key-free. When `pinned` is false (the current default — egress is not pinned on this infrastructure), do NOT build source-IP allowlists; signature verification is the authoritative control. When pinned, address changes are announced in the changelog at least 14 days ahead (the response's `policy` text says the same).\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/webhooks/egress-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"egressIps\": [\n      \"example_egressip\"\n    ],\n    \"pinned\": true,\n    \"verificationRequired\": true,\n    \"docUrl\": \"https://api.avrix.io/api/seller/v1/example\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/webhooks/egress-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "webhooks",
                    "egress-ips"
                  ]
                },
                "description": "**Webhook egress identity**\n\nThe source-IP identity of webhook deliveries, for firewall teams. Key-free. When `pinned` is false (the current default — egress is not pinned on this infrastructure), do NOT build source-IP allowlists; signature verification is the authoritative control. When pinned, address changes are announced in the changelog at least 14 days ahead (the response's `policy` text says the same).\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/webhooks/egress-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Events",
      "description": "Event feed for the authenticated seller — the pull-based counterpart to Webhooks.",
      "item": [
        {
          "name": "GET — Event feed",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/events?limit=50&cursor=&since=&eventType=order.cancelled%2Creturn.decided&resourceType=order&resourceId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "events"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset position from a previous page's `meta.nextCursor`. Takes precedence over `since`. 422 when malformed.",
                  "disabled": true
                },
                {
                  "key": "since",
                  "value": "",
                  "description": "Rows created strictly after this instant (full timestamp precision is honoured). Use for the first page or a time-based watermark. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "eventType",
                  "value": "order.cancelled,return.decided",
                  "description": "Contract date `2026-12-01` and later: only these event types. A comma-separated list, or the parameter repeated, of names from `GET /webhooks/event-types`; at most 20. An unknown name is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `eventType`). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                  "disabled": true
                },
                {
                  "key": "resourceType",
                  "value": "order",
                  "description": "Contract date `2026-12-01` and later: only events about this kind of resource (the event reference lists which events name which resource). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it. enum: order, chargeback, catalog_export, allocation, allocation_request, dispute_freeze, product, sku, contract_term, connection, connection_request, access_proposal, return_request, promotion, invoice, report, api_key, webhook_endpoint, platform_notice",
                  "disabled": true
                },
                {
                  "key": "resourceId",
                  "value": "",
                  "description": "Contract date `2026-12-01` and later: only events about this resource, by the id the Seller API names it with (for orders, your `orderReference`). Combine with `resourceType`. On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                  "disabled": true
                }
              ]
            },
            "description": "**Event feed**\n\nForward-only feed of your events. Start from a `since` ISO watermark, then follow `meta.nextCursor` (keyset on `createdAt`,`id`) until it is null: a burst of events sharing one timestamp pages through without loss or repetition, which `since` alone cannot guarantee. `meta.nextSince` remains for older clients. Requires `seller:webhooks:read`.\n\n**Contract date `2026-12-01` and later: the event log.** One row per event, whether or not any webhook endpoint subscribes to it, kept 30 days. Each row's `id` is the `eventLogId` every webhook delivery of that event carries, so the feed and your webhook handler deduplicate on the same value. Filter with `eventType` (one or more event names), `resourceType` and `resourceId`. A store with no webhook endpoint can follow its events from here alone. The feed reads a few seconds behind the present so that an event recorded a moment before a later one is never skipped.\n\n**Earlier contract dates: webhook deliveries.** One row per delivery to each of your endpoints (nothing when you have none), as before; `eventType`, `resourceType` and `resourceId` stay unknown there and are refused with `422 VALIDATION_FAILED` naming them, so a filter is never silently dropped.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Contract date `2026-12-01` and later: events from your event log (`SellerEventLogItem`). Earlier dates: webhook deliveries across all your endpoints (`SellerWebhookDeliveryCursorItem`). Both with `meta.nextCursor` / `meta.nextSince`.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/events?limit=50&cursor=&since=&eventType=order.cancelled%2Creturn.decided&resourceType=order&resourceId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "events"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset position from a previous page's `meta.nextCursor`. Takes precedence over `since`. 422 when malformed.",
                      "disabled": true
                    },
                    {
                      "key": "since",
                      "value": "",
                      "description": "Rows created strictly after this instant (full timestamp precision is honoured). Use for the first page or a time-based watermark. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "eventType",
                      "value": "order.cancelled,return.decided",
                      "description": "Contract date `2026-12-01` and later: only these event types. A comma-separated list, or the parameter repeated, of names from `GET /webhooks/event-types`; at most 20. An unknown name is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `eventType`). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                      "disabled": true
                    },
                    {
                      "key": "resourceType",
                      "value": "order",
                      "description": "Contract date `2026-12-01` and later: only events about this kind of resource (the event reference lists which events name which resource). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it. enum: order, chargeback, catalog_export, allocation, allocation_request, dispute_freeze, product, sku, contract_term, connection, connection_request, access_proposal, return_request, promotion, invoice, report, api_key, webhook_endpoint, platform_notice",
                      "disabled": true
                    },
                    {
                      "key": "resourceId",
                      "value": "",
                      "description": "Contract date `2026-12-01` and later: only events about this resource, by the id the Seller API names it with (for orders, your `orderReference`). Combine with `resourceType`. On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Event feed**\n\nForward-only feed of your events. Start from a `since` ISO watermark, then follow `meta.nextCursor` (keyset on `createdAt`,`id`) until it is null: a burst of events sharing one timestamp pages through without loss or repetition, which `since` alone cannot guarantee. `meta.nextSince` remains for older clients. Requires `seller:webhooks:read`.\n\n**Contract date `2026-12-01` and later: the event log.** One row per event, whether or not any webhook endpoint subscribes to it, kept 30 days. Each row's `id` is the `eventLogId` every webhook delivery of that event carries, so the feed and your webhook handler deduplicate on the same value. Filter with `eventType` (one or more event names), `resourceType` and `resourceId`. A store with no webhook endpoint can follow its events from here alone. The feed reads a few seconds behind the present so that an event recorded a moment before a later one is never skipped.\n\n**Earlier contract dates: webhook deliveries.** One row per delivery to each of your endpoints (nothing when you have none), as before; `eventType`, `resourceType` and `resourceId` stay unknown there and are refused with `422 VALIDATION_FAILED` naming them, so a filter is never silently dropped.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"f8b1b162-6475-452f-8e91-7bee491e5680\",\n      \"endpointId\": \"b5d5559b-0e6f-477e-8994-ea6aa3862d27\",\n      \"eventId\": \"e5170dbb-5d4a-4d60-8fcf-31bf4789a7bb\",\n      \"eventType\": \"order.fulfilled\",\n      \"status\": \"succeeded\",\n      \"attempts\": 1,\n      \"responseStatus\": 200,\n      \"payload\": {},\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"lastAttemptAt\": \"2026-11-02T09:30:00Z\",\n      \"nextRetryAt\": \"2026-11-02T09:30:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"requestId\": \"aa82c471-bca2-4e15-8e85-ebb8a8ee9cf7\",\n    \"nextSince\": \"2026-11-02T09:30:00Z\",\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"headCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/events?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/events?limit=50&cursor=&since=&eventType=order.cancelled%2Creturn.decided&resourceType=order&resourceId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "events"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset position from a previous page's `meta.nextCursor`. Takes precedence over `since`. 422 when malformed.",
                      "disabled": true
                    },
                    {
                      "key": "since",
                      "value": "",
                      "description": "Rows created strictly after this instant (full timestamp precision is honoured). Use for the first page or a time-based watermark. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "eventType",
                      "value": "order.cancelled,return.decided",
                      "description": "Contract date `2026-12-01` and later: only these event types. A comma-separated list, or the parameter repeated, of names from `GET /webhooks/event-types`; at most 20. An unknown name is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `eventType`). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                      "disabled": true
                    },
                    {
                      "key": "resourceType",
                      "value": "order",
                      "description": "Contract date `2026-12-01` and later: only events about this kind of resource (the event reference lists which events name which resource). On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it. enum: order, chargeback, catalog_export, allocation, allocation_request, dispute_freeze, product, sku, contract_term, connection, connection_request, access_proposal, return_request, promotion, invoice, report, api_key, webhook_endpoint, platform_notice",
                      "disabled": true
                    },
                    {
                      "key": "resourceId",
                      "value": "",
                      "description": "Contract date `2026-12-01` and later: only events about this resource, by the id the Seller API names it with (for orders, your `orderReference`). Combine with `resourceType`. On earlier dates the parameter is unknown, as it was before it existed: `422 VALIDATION_FAILED` naming it.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Event feed**\n\nForward-only feed of your events. Start from a `since` ISO watermark, then follow `meta.nextCursor` (keyset on `createdAt`,`id`) until it is null: a burst of events sharing one timestamp pages through without loss or repetition, which `since` alone cannot guarantee. `meta.nextSince` remains for older clients. Requires `seller:webhooks:read`.\n\n**Contract date `2026-12-01` and later: the event log.** One row per event, whether or not any webhook endpoint subscribes to it, kept 30 days. Each row's `id` is the `eventLogId` every webhook delivery of that event carries, so the feed and your webhook handler deduplicate on the same value. Filter with `eventType` (one or more event names), `resourceType` and `resourceId`. A store with no webhook endpoint can follow its events from here alone. The feed reads a few seconds behind the present so that an event recorded a moment before a later one is never skipped.\n\n**Earlier contract dates: webhook deliveries.** One row per delivery to each of your endpoints (nothing when you have none), as before; `eventType`, `resourceType` and `resourceId` stay unknown there and are refused with `422 VALIDATION_FAILED` naming them, so a filter is never silently dropped.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:webhooks:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Activity",
      "description": "Recent account activity for the authenticated seller: the settlement feed. Scope: `seller:finance:read` (legacy `seller:products:read` also accepted).",
      "item": [
        {
          "name": "GET — Settlement activity feed",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/activity?limit=50&cursor=&kinds=&from=&to=&promoId=&counterparty=&orderReference=&format=json&kind=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "activity"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from `meta.nextCursor`.",
                  "disabled": true
                },
                {
                  "key": "kinds",
                  "value": "",
                  "description": "Comma-separated `sale`, `refund`, `chargeback`, `reinstatement`, `pull`, `reveal` (default: all). Legacy: `transaction`, `webhook_delivery`.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Inclusive lower bound on `occurredAt` (ISO-8601). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Inclusive upper bound on `occurredAt` (ISO-8601). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "promoId",
                  "value": "",
                  "description": "Only entries discounted by this share / deal id. (UUID)",
                  "disabled": true
                },
                {
                  "key": "counterparty",
                  "value": "",
                  "description": "Only entries settled with this publisher company id.",
                  "disabled": true
                },
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Only entries for this order reference.",
                  "disabled": true
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` (default) or `csv`. `csv` answers `text/csv` as an attachment. enum: json, csv",
                  "disabled": true
                },
                {
                  "key": "kind",
                  "value": "",
                  "description": "Deprecated alias of `kinds`.",
                  "disabled": true
                }
              ]
            },
            "description": "**Settlement activity feed**\n\nOne keyset-pageable settlement feed at sale grain: `sale` (+1), `refund` / `chargeback` (-1), custody-only `pull` (+1) and keyless `reveal` (0) entries with counterparty, promo reference, buyer-country evidence and economics. Reconcile against this cursor instead of joining `/finance/api-sales`, `/transactions` and `/refunds`. `format=csv` renders the same rows (the next cursor is returned in `X-Next-Cursor`). Passing `kinds=transaction` or `kinds=webhook_delivery` returns the legacy merged shape for one release; webhook deliveries live on `GET /events` and `GET /webhooks/{id}/deliveries`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:finance:read`, `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/activity`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Settlement entries (or legacy rows when `kinds` is limited to legacy kinds).",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/activity?limit=50&cursor=&kinds=&from=&to=&promoId=&counterparty=&orderReference=&format=json&kind=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "activity"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor`.",
                      "disabled": true
                    },
                    {
                      "key": "kinds",
                      "value": "",
                      "description": "Comma-separated `sale`, `refund`, `chargeback`, `reinstatement`, `pull`, `reveal` (default: all). Legacy: `transaction`, `webhook_delivery`.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Inclusive lower bound on `occurredAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Inclusive upper bound on `occurredAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "promoId",
                      "value": "",
                      "description": "Only entries discounted by this share / deal id. (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "counterparty",
                      "value": "",
                      "description": "Only entries settled with this publisher company id.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Only entries for this order reference.",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. `csv` answers `text/csv` as an attachment. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "kind",
                      "value": "",
                      "description": "Deprecated alias of `kinds`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Settlement activity feed**\n\nOne keyset-pageable settlement feed at sale grain: `sale` (+1), `refund` / `chargeback` (-1), custody-only `pull` (+1) and keyless `reveal` (0) entries with counterparty, promo reference, buyer-country evidence and economics. Reconcile against this cursor instead of joining `/finance/api-sales`, `/transactions` and `/refunds`. `format=csv` renders the same rows (the next cursor is returned in `X-Next-Cursor`). Passing `kinds=transaction` or `kinds=webhook_delivery` returns the legacy merged shape for one release; webhook deliveries live on `GET /events` and `GET /webhooks/{id}/deliveries`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:finance:read`, `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/activity`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"e2cb4f3e-126e-4f0f-82d9-0b41234513ec\",\n      \"kind\": \"sale\",\n      \"occurredAt\": \"2026-11-02T09:30:00Z\",\n      \"stockMovement\": 12,\n      \"orderReference\": \"store-order-10432\",\n      \"keyId\": \"de6aa234-da2d-4804-8713-560cdb663e5f\",\n      \"keyPullId\": \"0b99fd3a-4b82-4a21-8318-56f877c4e2f2\",\n      \"skuId\": \"34544abf-96b1-42bd-826c-daf5b990f2c6\",\n      \"productId\": \"47a44a90-e4dd-45f5-81e9-d17d61b11ab4\",\n      \"counterparty\": {\n        \"publisherCompanyId\": \"acme-games\"\n      },\n      \"contractTermId\": \"314615e6-4f40-48c2-826d-e48f14f92d30\",\n      \"promo\": {\n        \"sourceType\": \"event\",\n        \"sourceId\": \"2db2e14a-d038-4d4b-87c1-c909b19ab04a\"\n      },\n      \"requestedCountry\": \"DE\",\n      \"detectedCountry\": \"DE\",\n      \"warnings\": [\n        \"COUNTRY_MISMATCH\"\n      ],\n      \"economics\": {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"unitPriceCents\": 2450,\n        \"unitPriceMinor\": 2450,\n        \"initialUnitPriceCents\": 2450,\n        \"initialUnitPriceMinor\": 2450,\n        \"publisherShareCents\": 2450,\n        \"publisherShareMinor\": 2450,\n        \"sellerShareCents\": 2450,\n        \"sellerShareMinor\": 2450,\n        \"platformFeeCents\": 2450,\n        \"platformFeeMinor\": 2450\n      },\n      \"adjustmentReference\": \"adj_10432\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true,\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/example?cursor=eyJ2IjoyfQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/activity?limit=50&cursor=&kinds=&from=&to=&promoId=&counterparty=&orderReference=&format=json&kind=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "activity"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from `meta.nextCursor`.",
                      "disabled": true
                    },
                    {
                      "key": "kinds",
                      "value": "",
                      "description": "Comma-separated `sale`, `refund`, `chargeback`, `reinstatement`, `pull`, `reveal` (default: all). Legacy: `transaction`, `webhook_delivery`.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Inclusive lower bound on `occurredAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Inclusive upper bound on `occurredAt` (ISO-8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "promoId",
                      "value": "",
                      "description": "Only entries discounted by this share / deal id. (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "counterparty",
                      "value": "",
                      "description": "Only entries settled with this publisher company id.",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Only entries for this order reference.",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. `csv` answers `text/csv` as an attachment. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "kind",
                      "value": "",
                      "description": "Deprecated alias of `kinds`.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Settlement activity feed**\n\nOne keyset-pageable settlement feed at sale grain: `sale` (+1), `refund` / `chargeback` (-1), custody-only `pull` (+1) and keyless `reveal` (0) entries with counterparty, promo reference, buyer-country evidence and economics. Reconcile against this cursor instead of joining `/finance/api-sales`, `/transactions` and `/refunds`. `format=csv` renders the same rows (the next cursor is returned in `X-Next-Cursor`). Passing `kinds=transaction` or `kinds=webhook_delivery` returns the legacy merged shape for one release; webhook deliveries live on `GET /events` and `GET /webhooks/{id}/deliveries`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:finance:read`, `seller:products:read`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/activity`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Usage",
      "description": "Aggregated API usage from `api_audit_log` (UTC window, default last 7 days).",
      "item": [
        {
          "name": "GET — API usage summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/usage?from=&to=&keyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "usage"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "",
                  "description": "Range start (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Range end (ISO 8601) (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "keyId",
                  "value": "",
                  "description": "Count only the requests made with this API key of yours (an `id` from `GET /keys` or `data.key.id` of `GET /whoami`). Omit it to count every key of the key owner in the calling key's environment. (UUID)",
                  "disabled": true
                }
              ]
            },
            "description": "**API usage summary**\n\nRequest counts for the key owner in the calling key's environment (UTC window, both ends inclusive; default: last 7 days), computed from the per-request call log: every response is counted once — successes, reads and denials included — never sampled. Retention of the call log is 90 days; ask for longer ranges in pieces.\n\nThe totals and the `byRoute`, `byStatus`, `byDay` and `byKey` breakdowns always cover the whole window, however many requests it holds. `byRoute` labels each endpoint as a template (`/v1/orders/{id}`: a path segment that contains a digit is an id); `byEndpoint` keeps path parameters as sent, so each id is its own entry, and lists at most `maxEndpointBuckets` entries, largest first (`truncated` is `true` when it leaves some out). `byStatus` gives the error code of every error response (`VALIDATION_FAILED`, `RATE_LIMIT_EXCEEDED`, ...); responses recorded before error codes were stored report `HTTP_<status>`. Pass `keyId` to count one of your keys only.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/usage`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Usage aggregates",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/usage?from=&to=&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "usage"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Range start (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Range end (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Count only the requests made with this API key of yours (an `id` from `GET /keys` or `data.key.id` of `GET /whoami`). Omit it to count every key of the key owner in the calling key's environment. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**API usage summary**\n\nRequest counts for the key owner in the calling key's environment (UTC window, both ends inclusive; default: last 7 days), computed from the per-request call log: every response is counted once — successes, reads and denials included — never sampled. Retention of the call log is 90 days; ask for longer ranges in pieces.\n\nThe totals and the `byRoute`, `byStatus`, `byDay` and `byKey` breakdowns always cover the whole window, however many requests it holds. `byRoute` labels each endpoint as a template (`/v1/orders/{id}`: a path segment that contains a digit is an id); `byEndpoint` keeps path parameters as sent, so each id is its own entry, and lists at most `maxEndpointBuckets` entries, largest first (`truncated` is `true` when it leaves some out). `byStatus` gives the error code of every error response (`VALIDATION_FAILED`, `RATE_LIMIT_EXCEEDED`, ...); responses recorded before error codes were stored report `HTTP_<status>`. Pass `keyId` to count one of your keys only.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/usage`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"from\": \"2026-11-02T09:30:00Z\",\n    \"to\": \"2026-11-02T09:30:00Z\",\n    \"truncated\": false,\n    \"maxCountedRequests\": 12,\n    \"totalRequests\": 2450,\n    \"totalLookupMisses\": 2450,\n    \"byEndpoint\": [\n      {\n        \"endpoint\": \"/api/seller/v1/orders\",\n        \"method\": \"POST\",\n        \"requests\": 1,\n        \"errors\": 1,\n        \"lookupMisses\": 1\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/usage?from=&to=&keyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "usage"
                  ],
                  "query": [
                    {
                      "key": "from",
                      "value": "",
                      "description": "Range start (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Range end (ISO 8601) (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "keyId",
                      "value": "",
                      "description": "Count only the requests made with this API key of yours (an `id` from `GET /keys` or `data.key.id` of `GET /whoami`). Omit it to count every key of the key owner in the calling key's environment. (UUID)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**API usage summary**\n\nRequest counts for the key owner in the calling key's environment (UTC window, both ends inclusive; default: last 7 days), computed from the per-request call log: every response is counted once — successes, reads and denials included — never sampled. Retention of the call log is 90 days; ask for longer ranges in pieces.\n\nThe totals and the `byRoute`, `byStatus`, `byDay` and `byKey` breakdowns always cover the whole window, however many requests it holds. `byRoute` labels each endpoint as a template (`/v1/orders/{id}`: a path segment that contains a digit is an id); `byEndpoint` keeps path parameters as sent, so each id is its own entry, and lists at most `maxEndpointBuckets` entries, largest first (`truncated` is `true` when it leaves some out). `byStatus` gives the error code of every error response (`VALIDATION_FAILED`, `RATE_LIMIT_EXCEEDED`, ...); responses recorded before error codes were stored report `HTTP_<status>`. Pass `keyId` to count one of your keys only.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/usage`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Finance",
      "description": "Finance summary, per-key API sale rows, and platform invoices under `/api/seller/v1/finance/...`. Scope: `seller:finance:read`.",
      "item": [
        {
          "name": "GET — Finance summary (seller)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/summary",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "summary"
              ]
            },
            "description": "**Finance summary (seller)**\n\nOutstanding balances per publisher relationship, draft sales report count, and recent monthly reports. **Not** key-pull history — use `/api/seller/v1/transactions` for pulls. Requires scope `seller:finance:read`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Seller finance overview payload",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "summary"
                  ]
                },
                "description": "**Finance summary (seller)**\n\nOutstanding balances per publisher relationship, draft sales report count, and recent monthly reports. **Not** key-pull history — use `/api/seller/v1/transactions` for pulls. Requires scope `seller:finance:read`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"outstandingByCurrency\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"cents\": 2450,\n        \"amountMinor\": 2450\n      }\n    ],\n    \"publisherRelationshipCount\": 12,\n    \"draftReportsCount\": 12,\n    \"paidThisMonthByCurrency\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"cents\": 2450,\n        \"amountMinor\": 2450\n      }\n    ],\n    \"paidThisMonthPaymentCount\": 12,\n    \"recentReports\": [\n      {\n        \"id\": \"7d5ef76b-571c-4e28-8dfe-9df6d0175702\",\n        \"counterpartyCompanyId\": \"1fc2ec87-3071-4ea4-81ba-ff938ca7780b\",\n        \"reportMonth\": \"2026-10\",\n        \"periodStart\": \"2026-10-01T00:00:00Z\",\n        \"periodEnd\": \"2026-10-31T23:59:59Z\",\n        \"modelType\": \"api\",\n        \"status\": \"draft\",\n        \"currencyCode\": \"EUR\",\n        \"totalNetRevenue\": 2450,\n        \"submittedAt\": \"2026-11-02T09:30:00Z\",\n        \"createdAt\": \"2026-11-02T09:30:00Z\",\n        \"updatedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"attentionReports\": [\n      {\n        \"id\": \"6c024eb6-4692-4248-894e-20b96c2a708d\",\n        \"counterpartyCompanyId\": \"e59900e0-8218-4cbf-8441-f0aa6e1870ec\",\n        \"reportMonth\": \"2026-10\",\n        \"periodStart\": \"2026-10-01T00:00:00Z\",\n        \"periodEnd\": \"2026-10-31T23:59:59Z\",\n        \"modelType\": \"api\",\n        \"status\": \"draft\",\n        \"currencyCode\": \"EUR\",\n        \"totalNetRevenue\": 2450,\n        \"submittedAt\": \"2026-11-02T09:30:00Z\",\n        \"createdAt\": \"2026-11-02T09:30:00Z\",\n        \"updatedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"currentPeriod\": {\n      \"period\": \"2026-10\",\n      \"apiSalesCount\": 12,\n      \"byCurrency\": [\n        {\n          \"currencyCode\": \"EUR\",\n          \"currencyExponent\": 2,\n          \"salesCount\": 12,\n          \"grossCents\": 2450,\n          \"sellerShareCents\": 2450,\n          \"publisherShareCents\": 2450\n        }\n      ],\n      \"truncated\": false\n    },\n    \"notices\": [\n      {\n        \"code\": \"API_SALES_NOT_YET_REPORTED\",\n        \"message\": \"Example text.\",\n        \"href\": \"https://api.avrix.io/api/seller/v1/example\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/summary",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "summary"
                  ]
                },
                "description": "**Finance summary (seller)**\n\nOutstanding balances per publisher relationship, draft sales report count, and recent monthly reports. **Not** key-pull history — use `/api/seller/v1/transactions` for pulls. Requires scope `seller:finance:read`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/summary`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — API sale transactions (seller)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales?limit=50&cursor=&from=&to=&format=json&orderReference=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "api-sales"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Return only sales at or after this time (inclusive). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Return only sales at or before this time (inclusive). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "Response format. `csv` streams the same rows as text/csv for finance tooling. enum: json, csv",
                  "disabled": true
                },
                {
                  "key": "orderReference",
                  "value": "",
                  "description": "Only the sale rows of this order reference.",
                  "disabled": true
                }
              ]
            },
            "description": "**API sale transactions (seller)**\n\nPer-key `sales.api_sale_transactions` rows for the authenticated seller. Paginated; `cursor` is the opaque value of `meta.nextCursor`, sent back unchanged. **Reference correction:** an earlier reference called it a numeric offset string; offset cursors issued before 2026-08 are still read. Optional `from` / `to` ISO 8601 filters on `sale_timestamp`. Requires `seller:finance:read`.\n\nCSV export (`format=csv`) columns: id, publisherCompanyId, keyPullId, keyId, skuId, productId, salePriceCents, currencyCode, currencyExponent, publisherShareCents, sellerShareCents, platformFeeCents, saleTimestamp, aggregationStatus, reportId, orderReference, adjustmentStatus, customerRegionCode, detectedCountryCode, warning (`COUNTRY_MISMATCH` when the buyer IP country disagreed with the declared sales country; empty otherwise), entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, evidenceRank, requestedCountry, promoSourceType, promoSourceId, initialSalePriceCents. Columns are only ever appended, so parse by header name. The settlement columns (vatMinor through requestedCountry) are empty when the row has no settlement. promoSourceType and promoSourceId name the promotion behind the price, also on refund, chargeback and reinstatement rows; initialSalePriceCents is empty on those correction rows and on secondary-currency promo sales.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Rows and pagination meta",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales?limit=50&cursor=&from=&to=&format=json&orderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "api-sales"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Return only sales at or after this time (inclusive). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Return only sales at or before this time (inclusive). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "Response format. `csv` streams the same rows as text/csv for finance tooling. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Only the sale rows of this order reference.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**API sale transactions (seller)**\n\nPer-key `sales.api_sale_transactions` rows for the authenticated seller. Paginated; `cursor` is the opaque value of `meta.nextCursor`, sent back unchanged. **Reference correction:** an earlier reference called it a numeric offset string; offset cursors issued before 2026-08 are still read. Optional `from` / `to` ISO 8601 filters on `sale_timestamp`. Requires `seller:finance:read`.\n\nCSV export (`format=csv`) columns: id, publisherCompanyId, keyPullId, keyId, skuId, productId, salePriceCents, currencyCode, currencyExponent, publisherShareCents, sellerShareCents, platformFeeCents, saleTimestamp, aggregationStatus, reportId, orderReference, adjustmentStatus, customerRegionCode, detectedCountryCode, warning (`COUNTRY_MISMATCH` when the buyer IP country disagreed with the declared sales country; empty otherwise), entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, evidenceRank, requestedCountry, promoSourceType, promoSourceId, initialSalePriceCents. Columns are only ever appended, so parse by header name. The settlement columns (vatMinor through requestedCountry) are empty when the row has no settlement. promoSourceType and promoSourceId name the promotion behind the price, also on refund, chargeback and reinstatement rows; initialSalePriceCents is empty on those correction rows and on secondary-currency promo sales.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"a60b9fab-3d09-442a-844d-e617db65231f\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"keyPullId\": \"af8b0aa1-3d3e-4e80-88b8-38305d982075\",\n      \"keyId\": \"679d14b2-55aa-4442-83f1-05f0c49546a6\",\n      \"skuId\": \"642ce6d2-a2eb-40b6-8860-bfd734921fd2\",\n      \"productId\": \"b531da56-0323-49cb-8df5-d5c908c73f9d\",\n      \"salePriceCents\": 2450,\n      \"initialSalePriceCents\": 2450,\n      \"promo\": {\n        \"sourceType\": \"event\",\n        \"sourceId\": \"f20e5306-668f-421c-8d92-24024cc9d657\"\n      },\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"publisherShareCents\": 2450,\n      \"sellerShareCents\": 2450,\n      \"platformFeeCents\": 2450,\n      \"revenueSharePercent\": 20,\n      \"saleTimestamp\": \"2026-11-02T09:30:00Z\",\n      \"aggregationStatus\": \"pending\",\n      \"reportId\": \"a2f58066-18cc-4865-84e4-8481f1133908\",\n      \"orderReference\": \"store-order-10432\",\n      \"customerRegionCode\": \"DE\",\n      \"detectedCountryCode\": \"off\",\n      \"countryMismatch\": true,\n      \"warnings\": [\n        \"COUNTRY_MISMATCH\"\n      ],\n      \"contractTermId\": \"5fb782c2-bc79-4364-83c0-eb0285111cbe\",\n      \"contractTermVersion\": 1,\n      \"adjustmentStatus\": \"none\",\n      \"declaredRetail\": {\n        \"retailCurrencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"grossMinor\": 2450,\n        \"netMinor\": 2450,\n        \"taxAmountMinor\": 2450,\n        \"taxRatePercent\": 20,\n        \"priceIncludesTax\": true,\n        \"paymentMethodFamily\": \"card\",\n        \"paymentProcessorReference\": \"pi_10432\",\n        \"checkoutSessionId\": \"cs_10432\",\n        \"purchaseOrderNumber\": \"PO-10432\"\n      },\n      \"integrationOrderContext\": {\n        \"schemaVersion\": 1,\n        \"consumerIp\": \"203.0.113.10\",\n        \"salesCountryCode\": \"CO\",\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"salesPriceGrossMinor\": 2450,\n        \"salesPriceNetMinor\": 2450,\n        \"appliedDiscountPercentage\": 20,\n        \"appliedDiscountAmountMinor\": 2450,\n        \"immediateFulfilment\": true,\n        \"mustFulfil\": true,\n        \"buyerLocale\": \"de-DE\",\n        \"priceIncludesTax\": true,\n        \"salesTaxAmountMinor\": 2450,\n        \"salesTaxRatePercent\": 20,\n        \"customerVatNumber\": \"DE123456789\",\n        \"purchaseOrderNumber\": \"PO-10432\",\n        \"customerType\": \"b2c\",\n        \"paymentMethodFamily\": \"card\",\n        \"paymentProcessorReference\": \"pi_10432\",\n        \"checkoutSessionId\": \"cs_10432\",\n        \"salesChannel\": \"web\",\n        \"lineIndex\": 1,\n        \"parentOrderReference\": \"store-order-10432\",\n        \"externalNetworkOrderId\": \"00f6fd41-72b0-4249-88a0-75af0a3d6bfa\",\n        \"consumerIpHash\": \"3f9a1c7e2b4d6a80\",\n        \"consumerIpRedacted\": true\n      },\n      \"taxMetadata\": {\n        \"declaredTaxAmountMinor\": 2450,\n        \"declaredTaxRatePercent\": 20,\n        \"priceIncludesTax\": true,\n        \"authoritative\": false\n      },\n      \"settlement\": {\n        \"basis\": \"purchaser_country_capped\",\n        \"vatMinor\": 2450,\n        \"netMinor\": 2450,\n        \"appliedRatePercent\": 20,\n        \"declaredRatePercent\": 20,\n        \"evidenceRank\": 1,\n        \"requestedCountry\": \"DE\"\n      },\n      \"entryType\": \"sale\",\n      \"reversesTransactionId\": \"974af312-319e-48e4-8153-7b12ebb53569\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/api-sales?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales?limit=50&cursor=&from=&to=&format=json&orderReference=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "api-sales"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Return only sales at or after this time (inclusive). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Return only sales at or before this time (inclusive). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "Response format. `csv` streams the same rows as text/csv for finance tooling. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "orderReference",
                      "value": "",
                      "description": "Only the sale rows of this order reference.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**API sale transactions (seller)**\n\nPer-key `sales.api_sale_transactions` rows for the authenticated seller. Paginated; `cursor` is the opaque value of `meta.nextCursor`, sent back unchanged. **Reference correction:** an earlier reference called it a numeric offset string; offset cursors issued before 2026-08 are still read. Optional `from` / `to` ISO 8601 filters on `sale_timestamp`. Requires `seller:finance:read`.\n\nCSV export (`format=csv`) columns: id, publisherCompanyId, keyPullId, keyId, skuId, productId, salePriceCents, currencyCode, currencyExponent, publisherShareCents, sellerShareCents, platformFeeCents, saleTimestamp, aggregationStatus, reportId, orderReference, adjustmentStatus, customerRegionCode, detectedCountryCode, warning (`COUNTRY_MISMATCH` when the buyer IP country disagreed with the declared sales country; empty otherwise), entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, evidenceRank, requestedCountry, promoSourceType, promoSourceId, initialSalePriceCents. Columns are only ever appended, so parse by header name. The settlement columns (vatMinor through requestedCountry) are empty when the row has no settlement. promoSourceType and promoSourceId name the promotion behind the price, also on refund, chargeback and reinstatement rows; initialSalePriceCents is empty on those correction rows and on secondary-currency promo sales.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List the invoices you owe",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/invoices?limit=50&cursor=&status=awaiting_commission_document%2Cpayable&kind=vendor_payable%2Cavrix_commission&invoiceType=proforma%2Cfinal&publisherCompanyId=&reportMonth=&issuedFrom=&issuedTo=&updatedSince=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "invoices"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "awaiting_commission_document,payable",
                  "description": "Only invoices in these states. Comma-separated; any of: `awaiting_commission_document`, `payable`, `disputed`, `overdue`, `paid`, `superseded`, `sent`, `cancelled`, `credited`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "kind",
                  "value": "vendor_payable,avrix_commission",
                  "description": "Only invoices of these kinds. Comma-separated; any of: `vendor_payable`, `avrix_commission`, `legacy_allocation`, `legacy_report`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "invoiceType",
                  "value": "proforma,final",
                  "description": "Only these invoice types. Comma-separated; any of: `proforma`, `final`, `credit_note`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "publisherCompanyId",
                  "value": "",
                  "description": "Only invoices from this vendor (company id).",
                  "disabled": true
                },
                {
                  "key": "reportMonth",
                  "value": "",
                  "description": "Only invoices for this sales month, `YYYY-MM`.",
                  "disabled": true
                },
                {
                  "key": "issuedFrom",
                  "value": "",
                  "description": "Issued at or after this instant. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "issuedTo",
                  "value": "",
                  "description": "Issued before this instant. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "updatedSince",
                  "value": "",
                  "description": "Changed at or after this instant (`updatedAt`). (ISO 8601)",
                  "disabled": true
                }
              ]
            },
            "description": "**List the invoices you owe**\n\nThe invoices you owe, newest issue date first: mostly each vendor's monthly invoice (`kind: vendor_payable`), plus documents of the earlier per-report and per-allocation billing. Read one with `GET /finance/invoices/{invoiceId}`, its payment with `GET /finance/payments`, and the sales it covers with `GET /finance/invoices/{invoiceId}/reconciliation`. Requires `seller:finance:read`.\n\n**Filters** (all optional, combined with AND): `status`, `kind`, `invoiceType`, `publisherCompanyId`, `reportMonth`, `issuedFrom` / `issuedTo` (issue date, `issuedTo` exclusive), `updatedSince` (sync changes since your last run).\n\n**Credit notes** carry a positive total; `invoiceType: credit_note` is what says the money comes back to you. A corrected invoice names the one it replaces in `replacesInvoiceId`; the replaced one has `status: superseded` and `supersededByInvoiceId`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Invoices and pagination meta",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices?limit=50&cursor=&status=awaiting_commission_document%2Cpayable&kind=vendor_payable%2Cavrix_commission&invoiceType=proforma%2Cfinal&publisherCompanyId=&reportMonth=&issuedFrom=&issuedTo=&updatedSince=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "awaiting_commission_document,payable",
                      "description": "Only invoices in these states. Comma-separated; any of: `awaiting_commission_document`, `payable`, `disputed`, `overdue`, `paid`, `superseded`, `sent`, `cancelled`, `credited`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "kind",
                      "value": "vendor_payable,avrix_commission",
                      "description": "Only invoices of these kinds. Comma-separated; any of: `vendor_payable`, `avrix_commission`, `legacy_allocation`, `legacy_report`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "invoiceType",
                      "value": "proforma,final",
                      "description": "Only these invoice types. Comma-separated; any of: `proforma`, `final`, `credit_note`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only invoices from this vendor (company id).",
                      "disabled": true
                    },
                    {
                      "key": "reportMonth",
                      "value": "",
                      "description": "Only invoices for this sales month, `YYYY-MM`.",
                      "disabled": true
                    },
                    {
                      "key": "issuedFrom",
                      "value": "",
                      "description": "Issued at or after this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "issuedTo",
                      "value": "",
                      "description": "Issued before this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Changed at or after this instant (`updatedAt`). (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List the invoices you owe**\n\nThe invoices you owe, newest issue date first: mostly each vendor's monthly invoice (`kind: vendor_payable`), plus documents of the earlier per-report and per-allocation billing. Read one with `GET /finance/invoices/{invoiceId}`, its payment with `GET /finance/payments`, and the sales it covers with `GET /finance/invoices/{invoiceId}/reconciliation`. Requires `seller:finance:read`.\n\n**Filters** (all optional, combined with AND): `status`, `kind`, `invoiceType`, `publisherCompanyId`, `reportMonth`, `issuedFrom` / `issuedTo` (issue date, `issuedTo` exclusive), `updatedSince` (sync changes since your last run).\n\n**Credit notes** carry a positive total; `invoiceType: credit_note` is what says the money comes back to you. A corrected invoice names the one it replaces in `replacesInvoiceId`; the replaced one has `status: superseded` and `supersededByInvoiceId`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"0f22d074-7c8c-4450-8673-fc01aa3dac00\",\n      \"invoiceNumber\": \"INV-2026-10-0042\",\n      \"status\": \"draft\",\n      \"invoiceType\": \"proforma\",\n      \"totalCents\": 2450,\n      \"totalMinor\": 2450,\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"issuedAt\": \"2026-11-02T09:30:00Z\",\n      \"dueAt\": \"2026-11-02T09:30:00Z\",\n      \"salesReportId\": \"e4295d17-8009-419e-8af4-0299aeaa068e\",\n      \"paidAt\": \"2026-11-02T09:30:00Z\",\n      \"platformInvoiceNumber\": \"example_platforminvoicenumber\",\n      \"kind\": \"vendor_payable\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"supplierInvoiceNumber\": \"example_supplierinvoicenumber\",\n      \"reportMonth\": \"2026-10\",\n      \"subtotalCents\": 2450,\n      \"subtotalMinor\": 2450,\n      \"taxCents\": 2450,\n      \"taxMinor\": 2450,\n      \"paidCents\": 2450,\n      \"paidMinor\": 2450,\n      \"outstandingCents\": 2450,\n      \"outstandingMinor\": 2450,\n      \"paymentTermsDays\": 1,\n      \"paymentState\": \"unpaid\",\n      \"replacesInvoiceId\": \"0775ef96-1516-4700-8b89-48e68867134a\",\n      \"supersededByInvoiceId\": \"3e91337b-9f5b-4ea3-871f-fe576eac6152\",\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"reconciliationAvailable\": true,\n      \"reconciliationPath\": \"example_reconciliationpath\",\n      \"detailPath\": \"example_detailpath\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/invoices?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\",\n    \"notices\": [\n      {\n        \"code\": \"API_SALES_NOT_YET_REPORTED\",\n        \"message\": \"Example text.\",\n        \"href\": \"https://api.avrix.io/api/seller/v1/example\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices?limit=50&cursor=&status=awaiting_commission_document%2Cpayable&kind=vendor_payable%2Cavrix_commission&invoiceType=proforma%2Cfinal&publisherCompanyId=&reportMonth=&issuedFrom=&issuedTo=&updatedSince=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque keyset cursor from meta.nextCursor. Do not construct or parse — echo it back verbatim. Legacy integer offset cursors from before 2026-08 remain accepted during transition.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "awaiting_commission_document,payable",
                      "description": "Only invoices in these states. Comma-separated; any of: `awaiting_commission_document`, `payable`, `disputed`, `overdue`, `paid`, `superseded`, `sent`, `cancelled`, `credited`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "kind",
                      "value": "vendor_payable,avrix_commission",
                      "description": "Only invoices of these kinds. Comma-separated; any of: `vendor_payable`, `avrix_commission`, `legacy_allocation`, `legacy_report`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "invoiceType",
                      "value": "proforma,final",
                      "description": "Only these invoice types. Comma-separated; any of: `proforma`, `final`, `credit_note`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only invoices from this vendor (company id).",
                      "disabled": true
                    },
                    {
                      "key": "reportMonth",
                      "value": "",
                      "description": "Only invoices for this sales month, `YYYY-MM`.",
                      "disabled": true
                    },
                    {
                      "key": "issuedFrom",
                      "value": "",
                      "description": "Issued at or after this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "issuedTo",
                      "value": "",
                      "description": "Issued before this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "updatedSince",
                      "value": "",
                      "description": "Changed at or after this instant (`updatedAt`). (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List the invoices you owe**\n\nThe invoices you owe, newest issue date first: mostly each vendor's monthly invoice (`kind: vendor_payable`), plus documents of the earlier per-report and per-allocation billing. Read one with `GET /finance/invoices/{invoiceId}`, its payment with `GET /finance/payments`, and the sales it covers with `GET /finance/invoices/{invoiceId}/reconciliation`. Requires `seller:finance:read`.\n\n**Filters** (all optional, combined with AND): `status`, `kind`, `invoiceType`, `publisherCompanyId`, `reportMonth`, `issuedFrom` / `issuedTo` (issue date, `issuedTo` exclusive), `updatedSince` (sync changes since your last run).\n\n**Credit notes** carry a positive total; `invoiceType: credit_note` is what says the money comes back to you. A corrected invoice names the one it replaces in `replacesInvoiceId`; the replaced one has `status: superseded` and `supersededByInvoiceId`.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Monthly finance statement",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/statements?period=2026-07&format=json&cursor=&limit=5000",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "statements"
              ],
              "query": [
                {
                  "key": "period",
                  "value": "2026-07",
                  "description": "Calendar month, `YYYY-MM` (UTC).",
                  "disabled": false
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` (default) or `csv` (transaction lines only). On contract date `2026-12-01` and later any other value is refused with 422; earlier dates answer JSON. enum: json, csv",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque nextCursor from the preceding page. Keep the same period.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "5000",
                  "description": "Maximum returned lines per page; activityTotals always covers the full period. (1–5000)",
                  "disabled": true
                }
              ]
            },
            "description": "**Monthly finance statement**\n\nReconcile monthly transaction activity with approved settlements and outstanding balances. Legacy totals cover the returned lines; activityTotals covers the entire month, including pending and quarantined entries. These are different financial views and must not be added together. Results are frozen for 30 minutes. Follow nextCursor with the same period to retrieve subsequent pages; an expired cursor returns 422 and requires restarting without a cursor. format=csv downloads one page and returns pagination metadata in X-Avrix-Statement-Total-Lines, X-Avrix-Statement-Truncated and X-Avrix-Statement-Next-Cursor headers. Invoicing remains a separate action following report approval.\n\n**Paging:** `meta` carries the shared list keys (`limit`, `hasMore`, `nextCursor`, `nextUrl`) beside `data.nextCursor` and `data.truncated`, which keep their meaning. The CSV carries `X-Next-Cursor` with the same value as `X-Avrix-Statement-Next-Cursor`. See `https://docs.avrix.io/seller-api/pagination`.\n\n**CSV columns:** id, saleTimestamp, orderReference, skuId, productId, publisherCompanyId, salePriceCents, currencyCode, publisherShareCents, sellerShareCents, platformFeeCents, adjustmentStatus, then (appended, so a statement line carries what the same sale carries in the api-sales CSV) currencyExponent, keyPullId, keyId, reportId, aggregationStatus, entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, requestedCountry, customerRegionCode, detectedCountryCode. Columns are only ever appended; parse by header name.\n\n**Contract date `2026-12-01` and later:** a `format` other than `json` or `csv` is refused with `422 VALIDATION_FAILED` (`details.field: format`; earlier dates answer JSON), a `limit` outside 1 to 5000 is reported against `limit` (earlier dates report it against `cursor`), and a failure of Avrix's own infrastructure answers `503` or `504` with `Retry-After` (earlier dates answer `500`). On every date a `500` carries a generic message.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/statements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Statement for the period",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/statements?period=2026-07&format=json&cursor=&limit=5000",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "statements"
                  ],
                  "query": [
                    {
                      "key": "period",
                      "value": "2026-07",
                      "description": "Calendar month, `YYYY-MM` (UTC).",
                      "disabled": false
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv` (transaction lines only). On contract date `2026-12-01` and later any other value is refused with 422; earlier dates answer JSON. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque nextCursor from the preceding page. Keep the same period.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "5000",
                      "description": "Maximum returned lines per page; activityTotals always covers the full period. (1–5000)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Monthly finance statement**\n\nReconcile monthly transaction activity with approved settlements and outstanding balances. Legacy totals cover the returned lines; activityTotals covers the entire month, including pending and quarantined entries. These are different financial views and must not be added together. Results are frozen for 30 minutes. Follow nextCursor with the same period to retrieve subsequent pages; an expired cursor returns 422 and requires restarting without a cursor. format=csv downloads one page and returns pagination metadata in X-Avrix-Statement-Total-Lines, X-Avrix-Statement-Truncated and X-Avrix-Statement-Next-Cursor headers. Invoicing remains a separate action following report approval.\n\n**Paging:** `meta` carries the shared list keys (`limit`, `hasMore`, `nextCursor`, `nextUrl`) beside `data.nextCursor` and `data.truncated`, which keep their meaning. The CSV carries `X-Next-Cursor` with the same value as `X-Avrix-Statement-Next-Cursor`. See `https://docs.avrix.io/seller-api/pagination`.\n\n**CSV columns:** id, saleTimestamp, orderReference, skuId, productId, publisherCompanyId, salePriceCents, currencyCode, publisherShareCents, sellerShareCents, platformFeeCents, adjustmentStatus, then (appended, so a statement line carries what the same sale carries in the api-sales CSV) currencyExponent, keyPullId, keyId, reportId, aggregationStatus, entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, requestedCountry, customerRegionCode, detectedCountryCode. Columns are only ever appended; parse by header name.\n\n**Contract date `2026-12-01` and later:** a `format` other than `json` or `csv` is refused with `422 VALIDATION_FAILED` (`details.field: format`; earlier dates answer JSON), a `limit` outside 1 to 5000 is reported against `limit` (earlier dates report it against `cursor`), and a failure of Avrix's own infrastructure answers `503` or `504` with `Retry-After` (earlier dates answer `500`). On every date a `500` carries a generic message.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/statements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"period\": \"2026-10\",\n    \"periodStart\": \"2026-10-01T00:00:00Z\",\n    \"periodEnd\": \"2026-10-31T23:59:59Z\",\n    \"generatedAt\": \"2026-11-02T09:30:00Z\",\n    \"totals\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"transactionCount\": 3,\n        \"grossSalesCents\": 4900,\n        \"grossSalesMinor\": 4900,\n        \"refundedCents\": 2450,\n        \"refundedMinor\": 2450,\n        \"reinstatedCents\": 0,\n        \"reinstatedMinor\": 0,\n        \"netSalesCents\": 2450,\n        \"netSalesMinor\": 2450,\n        \"publisherShareCents\": 1960,\n        \"publisherShareMinor\": 1960,\n        \"sellerShareCents\": 245,\n        \"sellerShareMinor\": 245,\n        \"platformFeeCents\": 245,\n        \"platformFeeMinor\": 245\n      }\n    ],\n    \"lines\": [\n      {\n        \"id\": \"6f1c2a9e-3b7d-4e21-9c84-0a5d2e7b1f30\",\n        \"publisherCompanyId\": \"acme-games\",\n        \"keyPullId\": \"c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"keyId\": \"0e8f6a1b-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n        \"skuId\": \"69ee8d02-27c6-4f5a-8d87-fae0cdaf2100\",\n        \"productId\": \"afa398b3-94fd-4e2a-8e1d-43f1048e3383\",\n        \"salePriceCents\": 2450,\n        \"initialSalePriceCents\": 2450,\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"publisherShareCents\": 1960,\n        \"sellerShareCents\": 245,\n        \"platformFeeCents\": 245,\n        \"revenueSharePercent\": 80,\n        \"saleTimestamp\": \"2026-10-04T14:12:09Z\",\n        \"aggregationStatus\": \"aggregated\",\n        \"reportId\": \"356a5c58-1b6d-4605-8073-7137f2bda6e5\",\n        \"orderReference\": \"store-order-10432\",\n        \"customerRegionCode\": \"DE\",\n        \"detectedCountryCode\": \"DE\",\n        \"countryMismatch\": false,\n        \"warnings\": [],\n        \"contractTermId\": \"fd6a5a98-51b2-438e-8236-b9ef5c394db5\",\n        \"contractTermVersion\": 1,\n        \"adjustmentStatus\": \"refunded\",\n        \"declaredRetail\": {\n          \"retailCurrencyCode\": \"EUR\",\n          \"currencyExponent\": 2,\n          \"grossMinor\": 2450,\n          \"netMinor\": 2042,\n          \"taxAmountMinor\": 408,\n          \"taxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"paymentMethodFamily\": \"card\",\n          \"paymentProcessorReference\": \"pi_10432\",\n          \"checkoutSessionId\": \"cs_10432\",\n          \"purchaseOrderNumber\": \"PO-10432\"\n        },\n        \"integrationOrderContext\": null,\n        \"taxMetadata\": {\n          \"declaredTaxAmountMinor\": 408,\n          \"declaredTaxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"authoritative\": false\n        },\n        \"settlement\": {\n          \"basis\": \"purchaser_country_capped\",\n          \"vatMinor\": 408,\n          \"netMinor\": 2042,\n          \"appliedRatePercent\": 20,\n          \"declaredRatePercent\": 20,\n          \"rateReason\": \"corroborated\",\n          \"evidenceRank\": 1,\n          \"requestedCountry\": \"DE\"\n        },\n        \"entryType\": \"sale\",\n        \"reversesTransactionId\": null\n      },\n      {\n        \"id\": \"8d2e4b6a-1c3f-4a57-b0e9-5f7a3c9d2e14\",\n        \"publisherCompanyId\": \"acme-games\",\n        \"keyPullId\": \"d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f60\",\n        \"keyId\": \"1f9a7b2c-3d4e-4f5a-9b0c-2d3e4f5a6b7c\",\n        \"skuId\": \"69ee8d02-27c6-4f5a-8d87-fae0cdaf2100\",\n        \"productId\": \"afa398b3-94fd-4e2a-8e1d-43f1048e3383\",\n        \"salePriceCents\": 2450,\n        \"initialSalePriceCents\": 2450,\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"publisherShareCents\": 1960,\n        \"sellerShareCents\": 245,\n        \"platformFeeCents\": 245,\n        \"revenueSharePercent\": 80,\n        \"saleTimestamp\": \"2026-10-09T08:41:55Z\",\n        \"aggregationStatus\": \"aggregated\",\n        \"reportId\": \"356a5c58-1b6d-4605-8073-7137f2bda6e5\",\n        \"orderReference\": \"store-order-10519\",\n        \"customerRegionCode\": \"DE\",\n        \"detectedCountryCode\": \"DE\",\n        \"countryMismatch\": false,\n        \"warnings\": [],\n        \"contractTermId\": \"fd6a5a98-51b2-438e-8236-b9ef5c394db5\",\n        \"contractTermVersion\": 1,\n        \"adjustmentStatus\": \"none\",\n        \"declaredRetail\": {\n          \"retailCurrencyCode\": \"EUR\",\n          \"currencyExponent\": 2,\n          \"grossMinor\": 2450,\n          \"netMinor\": 2042,\n          \"taxAmountMinor\": 408,\n          \"taxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"paymentMethodFamily\": \"card\",\n          \"paymentProcessorReference\": \"pi_10432\",\n          \"checkoutSessionId\": \"cs_10432\",\n          \"purchaseOrderNumber\": \"PO-10432\"\n        },\n        \"integrationOrderContext\": null,\n        \"taxMetadata\": {\n          \"declaredTaxAmountMinor\": 408,\n          \"declaredTaxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"authoritative\": false\n        },\n        \"settlement\": {\n          \"basis\": \"purchaser_country_capped\",\n          \"vatMinor\": 408,\n          \"netMinor\": 2042,\n          \"appliedRatePercent\": 20,\n          \"declaredRatePercent\": 20,\n          \"rateReason\": \"corroborated\",\n          \"evidenceRank\": 1,\n          \"requestedCountry\": \"DE\"\n        },\n        \"entryType\": \"sale\",\n        \"reversesTransactionId\": null\n      },\n      {\n        \"id\": \"2b9f7c1d-6e4a-4f83-a2c5-9d1e8b3f7a60\",\n        \"publisherCompanyId\": \"acme-games\",\n        \"keyPullId\": \"c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"keyId\": \"0e8f6a1b-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n        \"skuId\": \"69ee8d02-27c6-4f5a-8d87-fae0cdaf2100\",\n        \"productId\": \"afa398b3-94fd-4e2a-8e1d-43f1048e3383\",\n        \"salePriceCents\": -2450,\n        \"initialSalePriceCents\": null,\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"publisherShareCents\": -1960,\n        \"sellerShareCents\": -245,\n        \"platformFeeCents\": -245,\n        \"revenueSharePercent\": 80,\n        \"saleTimestamp\": \"2026-10-06T10:03:27Z\",\n        \"aggregationStatus\": \"aggregated\",\n        \"reportId\": \"356a5c58-1b6d-4605-8073-7137f2bda6e5\",\n        \"orderReference\": \"store-order-10432\",\n        \"customerRegionCode\": \"DE\",\n        \"detectedCountryCode\": \"DE\",\n        \"countryMismatch\": false,\n        \"warnings\": [],\n        \"contractTermId\": \"fd6a5a98-51b2-438e-8236-b9ef5c394db5\",\n        \"contractTermVersion\": 1,\n        \"adjustmentStatus\": \"refunded\",\n        \"declaredRetail\": {\n          \"retailCurrencyCode\": \"EUR\",\n          \"currencyExponent\": 2,\n          \"grossMinor\": -2450,\n          \"netMinor\": -2042,\n          \"taxAmountMinor\": -408,\n          \"taxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"paymentMethodFamily\": \"card\",\n          \"paymentProcessorReference\": \"pi_10432\",\n          \"checkoutSessionId\": \"cs_10432\",\n          \"purchaseOrderNumber\": \"PO-10432\"\n        },\n        \"integrationOrderContext\": null,\n        \"taxMetadata\": {\n          \"declaredTaxAmountMinor\": -408,\n          \"declaredTaxRatePercent\": 20,\n          \"priceIncludesTax\": true,\n          \"authoritative\": false\n        },\n        \"settlement\": {\n          \"basis\": \"purchaser_country_capped\",\n          \"vatMinor\": -408,\n          \"netMinor\": -2042,\n          \"appliedRatePercent\": 20,\n          \"declaredRatePercent\": 20,\n          \"rateReason\": \"corroborated\",\n          \"evidenceRank\": 1,\n          \"requestedCountry\": \"DE\"\n        },\n        \"entryType\": \"sale_reversal\",\n        \"reversesTransactionId\": \"6f1c2a9e-3b7d-4e21-9c84-0a5d2e7b1f30\"\n      }\n    ],\n    \"lineCount\": 3,\n    \"truncated\": false,\n    \"totalsScope\": \"returned_lines\",\n    \"totalLineCount\": 3,\n    \"nextCursor\": null,\n    \"snapshotExpiresAt\": \"2026-11-02T09:30:00Z\",\n    \"activityTotals\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"transactionCount\": 3,\n        \"grossSalesCents\": 4900,\n        \"grossSalesMinor\": 4900,\n        \"refundedCents\": 2450,\n        \"refundedMinor\": 2450,\n        \"reinstatedCents\": 0,\n        \"reinstatedMinor\": 0,\n        \"netSalesCents\": 2450,\n        \"netSalesMinor\": 2450,\n        \"publisherShareCents\": 1960,\n        \"publisherShareMinor\": 1960,\n        \"sellerShareCents\": 245,\n        \"sellerShareMinor\": 245,\n        \"platformFeeCents\": 245,\n        \"platformFeeMinor\": 245\n      }\n    ],\n    \"pendingTotals\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"transactionCount\": 0,\n        \"grossSalesCents\": 0,\n        \"grossSalesMinor\": 0,\n        \"refundedCents\": 0,\n        \"refundedMinor\": 0,\n        \"reinstatedCents\": 0,\n        \"reinstatedMinor\": 0,\n        \"netSalesCents\": 0,\n        \"netSalesMinor\": 0,\n        \"publisherShareCents\": 0,\n        \"publisherShareMinor\": 0,\n        \"sellerShareCents\": 0,\n        \"sellerShareMinor\": 0,\n        \"platformFeeCents\": 0,\n        \"platformFeeMinor\": 0\n      }\n    ],\n    \"quarantinedTotals\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"transactionCount\": 0,\n        \"grossSalesCents\": 0,\n        \"grossSalesMinor\": 0,\n        \"refundedCents\": 0,\n        \"refundedMinor\": 0,\n        \"reinstatedCents\": 0,\n        \"reinstatedMinor\": 0,\n        \"netSalesCents\": 0,\n        \"netSalesMinor\": 0,\n        \"publisherShareCents\": 0,\n        \"publisherShareMinor\": 0,\n        \"sellerShareCents\": 0,\n        \"sellerShareMinor\": 0,\n        \"platformFeeCents\": 0,\n        \"platformFeeMinor\": 0\n      }\n    ],\n    \"approvedSettlements\": [\n      {\n        \"reportId\": \"0bfe9b56-52e6-4ac2-8bcd-c21d0a6fc788\",\n        \"publisherCompanyId\": \"acme-games\",\n        \"contractTermId\": \"53cd94e3-380e-423a-8fd5-18bbf7754d01\",\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"publisherShareMinor\": 1960,\n        \"status\": \"approved\",\n        \"invoices\": [\n          {\n            \"invoiceId\": \"fc213173-5c66-4946-8dc0-f44b5086b1c0\",\n            \"status\": \"payable\",\n            \"currencyCode\": \"EUR\",\n            \"currencyExponent\": 2,\n            \"totalMinor\": 1960\n          }\n        ]\n      }\n    ],\n    \"outstandingBalances\": [\n      {\n        \"publisherCompanyId\": \"acme-games\",\n        \"contractTermId\": \"cfb08fe0-3148-4900-8119-3e41a2cc7b3f\",\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"outstandingMinor\": 2450\n      }\n    ]\n  },\n  \"meta\": {\n    \"limit\": 50,\n    \"hasMore\": false,\n    \"nextCursor\": null,\n    \"nextUrl\": null\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/statements?period=2026-07&format=json&cursor=&limit=5000",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "statements"
                  ],
                  "query": [
                    {
                      "key": "period",
                      "value": "2026-07",
                      "description": "Calendar month, `YYYY-MM` (UTC).",
                      "disabled": false
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv` (transaction lines only). On contract date `2026-12-01` and later any other value is refused with 422; earlier dates answer JSON. enum: json, csv",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque nextCursor from the preceding page. Keep the same period.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "5000",
                      "description": "Maximum returned lines per page; activityTotals always covers the full period. (1–5000)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Monthly finance statement**\n\nReconcile monthly transaction activity with approved settlements and outstanding balances. Legacy totals cover the returned lines; activityTotals covers the entire month, including pending and quarantined entries. These are different financial views and must not be added together. Results are frozen for 30 minutes. Follow nextCursor with the same period to retrieve subsequent pages; an expired cursor returns 422 and requires restarting without a cursor. format=csv downloads one page and returns pagination metadata in X-Avrix-Statement-Total-Lines, X-Avrix-Statement-Truncated and X-Avrix-Statement-Next-Cursor headers. Invoicing remains a separate action following report approval.\n\n**Paging:** `meta` carries the shared list keys (`limit`, `hasMore`, `nextCursor`, `nextUrl`) beside `data.nextCursor` and `data.truncated`, which keep their meaning. The CSV carries `X-Next-Cursor` with the same value as `X-Avrix-Statement-Next-Cursor`. See `https://docs.avrix.io/seller-api/pagination`.\n\n**CSV columns:** id, saleTimestamp, orderReference, skuId, productId, publisherCompanyId, salePriceCents, currencyCode, publisherShareCents, sellerShareCents, platformFeeCents, adjustmentStatus, then (appended, so a statement line carries what the same sale carries in the api-sales CSV) currencyExponent, keyPullId, keyId, reportId, aggregationStatus, entryType, reversesTransactionId, vatMinor, netMinor, appliedRatePercent, rateReason, requestedCountry, customerRegionCode, detectedCountryCode. Columns are only ever appended; parse by header name.\n\n**Contract date `2026-12-01` and later:** a `format` other than `json` or `csv` is refused with `422 VALIDATION_FAILED` (`details.field: format`; earlier dates answer JSON), a `limit` outside 1 to 5000 is reported against `limit` (earlier dates report it against `cursor`), and a failure of Avrix's own infrastructure answers `503` or `504` with `Retry-After` (earlier dates answer `500`). On every date a `500` carries a generic message.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/statements`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Read the finance ledger",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/ledger?period=2026-09&from=&to=&currency=&cursor=&limit=500&format=json",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "ledger"
              ],
              "query": [
                {
                  "key": "period",
                  "value": "2026-09",
                  "description": "UTC calendar month, `YYYY-MM`. Send this or `from` and `to`.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "",
                  "description": "Window start, inclusive (ISO 8601). (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "",
                  "description": "Window end, exclusive (ISO 8601). At most 366 days after `from`. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "currency",
                  "value": "",
                  "description": "Only entries in this currency (ISO 4217).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque `meta.nextCursor` from the previous page. Keep the same window and currency.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "500",
                  "description": "Entries per page. (1–1000)",
                  "disabled": true
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` (default) or `csv`. enum: json, csv",
                  "disabled": true
                }
              ]
            },
            "description": "**Read the finance ledger**\n\nYour money ledger for one window: every sale, refund, chargeback and reinstatement entry, oldest first, with running balances per currency. Refunds and chargebacks are their own negative entries, and an entry's amounts never change once returned. Pull and reveal entries move stock, not money, and are on `GET /activity` only.\n\nPass `period=YYYY-MM` (a UTC calendar month, the same window a statement covers) or `from` and `to` (at most 366 days). Balances start at zero at the start of the window and run per currency; `balanceAfter` on each entry includes that entry. `meta.balances` holds the closing balances of the whole window on every page: for a calendar month they equal `activityTotals` of `GET /finance/statements` for the same period, field for field.\n\nPage with `meta.nextCursor` until `meta.hasMore` is false; balances continue exactly across pages. Balances are computed per request, so an entry recorded late with an earlier timestamp moves the balances after it, never the entry itself.\n\n`format=csv` returns the same page with the columns `entryId`, `kind`, `occurredAt`, `currencyCode`, `currencyExponent`, `publisherCompanyId`, `orderReference`, `keyId`, `skuId`, `transactionId`, `adjustmentReference`, `grossCents`, `publisherShareCents`, `sellerShareCents`, `platformFeeCents`, `balanceNetSalesCents`, `balancePublisherShareCents`, `balanceSellerShareCents`, `balancePlatformFeeCents`; the next cursor is in the `X-Next-Cursor` header.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/ledger`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 One page of the ledger.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/ledger?period=2026-09&from=&to=&currency=&cursor=&limit=500&format=json",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "ledger"
                  ],
                  "query": [
                    {
                      "key": "period",
                      "value": "2026-09",
                      "description": "UTC calendar month, `YYYY-MM`. Send this or `from` and `to`.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Window start, inclusive (ISO 8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Window end, exclusive (ISO 8601). At most 366 days after `from`. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "currency",
                      "value": "",
                      "description": "Only entries in this currency (ISO 4217).",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque `meta.nextCursor` from the previous page. Keep the same window and currency.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Entries per page. (1–1000)",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. enum: json, csv",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Read the finance ledger**\n\nYour money ledger for one window: every sale, refund, chargeback and reinstatement entry, oldest first, with running balances per currency. Refunds and chargebacks are their own negative entries, and an entry's amounts never change once returned. Pull and reveal entries move stock, not money, and are on `GET /activity` only.\n\nPass `period=YYYY-MM` (a UTC calendar month, the same window a statement covers) or `from` and `to` (at most 366 days). Balances start at zero at the start of the window and run per currency; `balanceAfter` on each entry includes that entry. `meta.balances` holds the closing balances of the whole window on every page: for a calendar month they equal `activityTotals` of `GET /finance/statements` for the same period, field for field.\n\nPage with `meta.nextCursor` until `meta.hasMore` is false; balances continue exactly across pages. Balances are computed per request, so an entry recorded late with an earlier timestamp moves the balances after it, never the entry itself.\n\n`format=csv` returns the same page with the columns `entryId`, `kind`, `occurredAt`, `currencyCode`, `currencyExponent`, `publisherCompanyId`, `orderReference`, `keyId`, `skuId`, `transactionId`, `adjustmentReference`, `grossCents`, `publisherShareCents`, `sellerShareCents`, `platformFeeCents`, `balanceNetSalesCents`, `balancePublisherShareCents`, `balanceSellerShareCents`, `balancePlatformFeeCents`; the next cursor is in the `X-Next-Cursor` header.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/ledger`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"entryId\": \"cf1c0954-f0b1-4f1e-8b63-865b0d60d866\",\n      \"kind\": \"sale\",\n      \"occurredAt\": \"2026-11-02T09:30:00Z\",\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"publisherCompanyId\": \"acme-games\",\n      \"orderReference\": \"store-order-10432\",\n      \"keyId\": \"64e281c0-dc16-467e-8f29-57e621c679c4\",\n      \"skuId\": \"1c3a99a7-3fc0-4a9a-8b3b-2848e84ef893\",\n      \"transactionId\": \"d2e7d9f6-fe3c-4b76-8a0f-b8ec5644d42e\",\n      \"adjustmentReference\": \"adj_10432\",\n      \"grossCents\": 2450,\n      \"grossMinor\": 2450,\n      \"publisherShareCents\": 2450,\n      \"publisherShareMinor\": 2450,\n      \"sellerShareCents\": 2450,\n      \"sellerShareMinor\": 2450,\n      \"platformFeeCents\": 2450,\n      \"platformFeeMinor\": 2450,\n      \"balanceAfter\": {\n        \"netSalesCents\": 2450,\n        \"netSalesMinor\": 2450,\n        \"publisherShareCents\": 2450,\n        \"publisherShareMinor\": 2450,\n        \"sellerShareCents\": 2450,\n        \"sellerShareMinor\": 2450,\n        \"platformFeeCents\": 2450,\n        \"platformFeeMinor\": 2450\n      }\n    }\n  ],\n  \"meta\": {\n    \"from\": \"2026-11-02T09:30:00Z\",\n    \"to\": \"2026-11-02T09:30:00Z\",\n    \"currency\": \"EUR\",\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"balances\": [\n      {\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"entryCount\": 12,\n        \"grossSalesCents\": 2450,\n        \"grossSalesMinor\": 2450,\n        \"refundedCents\": 2450,\n        \"refundedMinor\": 2450,\n        \"reinstatedCents\": 2450,\n        \"reinstatedMinor\": 2450,\n        \"netSalesCents\": 2450,\n        \"netSalesMinor\": 2450,\n        \"publisherShareCents\": 2450,\n        \"publisherShareMinor\": 2450,\n        \"sellerShareCents\": 2450,\n        \"sellerShareMinor\": 2450,\n        \"platformFeeCents\": 2450,\n        \"platformFeeMinor\": 2450\n      }\n    ],\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/ledger?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/ledger?period=2026-09&from=&to=&currency=&cursor=&limit=500&format=json",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "ledger"
                  ],
                  "query": [
                    {
                      "key": "period",
                      "value": "2026-09",
                      "description": "UTC calendar month, `YYYY-MM`. Send this or `from` and `to`.",
                      "disabled": true
                    },
                    {
                      "key": "from",
                      "value": "",
                      "description": "Window start, inclusive (ISO 8601). (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "to",
                      "value": "",
                      "description": "Window end, exclusive (ISO 8601). At most 366 days after `from`. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "currency",
                      "value": "",
                      "description": "Only entries in this currency (ISO 4217).",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque `meta.nextCursor` from the previous page. Keep the same window and currency.",
                      "disabled": true
                    },
                    {
                      "key": "limit",
                      "value": "500",
                      "description": "Entries per page. (1–1000)",
                      "disabled": true
                    },
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. enum: json, csv",
                      "disabled": true
                    }
                  ]
                },
                "description": "**Read the finance ledger**\n\nYour money ledger for one window: every sale, refund, chargeback and reinstatement entry, oldest first, with running balances per currency. Refunds and chargebacks are their own negative entries, and an entry's amounts never change once returned. Pull and reveal entries move stock, not money, and are on `GET /activity` only.\n\nPass `period=YYYY-MM` (a UTC calendar month, the same window a statement covers) or `from` and `to` (at most 366 days). Balances start at zero at the start of the window and run per currency; `balanceAfter` on each entry includes that entry. `meta.balances` holds the closing balances of the whole window on every page: for a calendar month they equal `activityTotals` of `GET /finance/statements` for the same period, field for field.\n\nPage with `meta.nextCursor` until `meta.hasMore` is false; balances continue exactly across pages. Balances are computed per request, so an entry recorded late with an earlier timestamp moves the balances after it, never the entry itself.\n\n`format=csv` returns the same page with the columns `entryId`, `kind`, `occurredAt`, `currencyCode`, `currencyExponent`, `publisherCompanyId`, `orderReference`, `keyId`, `skuId`, `transactionId`, `adjustmentReference`, `grossCents`, `publisherShareCents`, `sellerShareCents`, `platformFeeCents`, `balanceNetSalesCents`, `balancePublisherShareCents`, `balanceSellerShareCents`, `balancePlatformFeeCents`; the next cursor is in the `X-Next-Cursor` header.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/ledger`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Read one API sale transaction",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales/:transactionId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "api-sales",
                ":transactionId"
              ],
              "variable": [
                {
                  "key": "transactionId",
                  "value": "{{transactionId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Read one API sale transaction**\n\nOne sale as the ledger recorded it: what it settled at, which entry type it is, and, for a reversal, which sale it reverses. The list endpoint answers what happened this period; this answers why a statement line says what it does.\n\nA transaction id belonging to another seller returns 404 rather than 403, because a 403 would confirm the row exists.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales/{transactionId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The transaction as recorded.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales/:transactionId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "api-sales",
                    ":transactionId"
                  ],
                  "variable": [
                    {
                      "key": "transactionId",
                      "value": "{{transactionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Read one API sale transaction**\n\nOne sale as the ledger recorded it: what it settled at, which entry type it is, and, for a reversal, which sale it reverses. The list endpoint answers what happened this period; this answers why a statement line says what it does.\n\nA transaction id belonging to another seller returns 404 rather than 403, because a 403 would confirm the row exists.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales/{transactionId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"dccbd8ff-f8fd-4028-819c-7f8312149a95\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"keyPullId\": \"e66ef578-0a56-4388-8525-f9e2bcbaa25b\",\n    \"keyId\": \"817cb628-855b-49e4-8370-1b14e3a2f74e\",\n    \"skuId\": \"9c944f34-dcd1-4324-831e-22a645789f57\",\n    \"productId\": \"bf59624f-29fd-4778-8ba0-770d60cc587c\",\n    \"salePriceCents\": 2450,\n    \"initialSalePriceCents\": 2450,\n    \"promo\": {\n      \"sourceType\": \"event\",\n      \"sourceId\": \"dac88cf9-d3ea-4992-866b-c1b3ce46d678\"\n    },\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"publisherShareCents\": 2450,\n    \"sellerShareCents\": 2450,\n    \"platformFeeCents\": 2450,\n    \"revenueSharePercent\": 20,\n    \"saleTimestamp\": \"2026-11-02T09:30:00Z\",\n    \"aggregationStatus\": \"pending\",\n    \"reportId\": \"75ecb281-7b35-4533-8792-03f966e2e2a8\",\n    \"orderReference\": \"store-order-10432\",\n    \"customerRegionCode\": \"DE\",\n    \"detectedCountryCode\": \"off\",\n    \"countryMismatch\": true,\n    \"warnings\": [\n      \"COUNTRY_MISMATCH\"\n    ],\n    \"contractTermId\": \"653e65d5-22ed-48dd-866c-6169d8e12b2f\",\n    \"contractTermVersion\": 1,\n    \"adjustmentStatus\": \"none\",\n    \"declaredRetail\": {\n      \"retailCurrencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"grossMinor\": 2450,\n      \"netMinor\": 2450,\n      \"taxAmountMinor\": 2450,\n      \"taxRatePercent\": 20,\n      \"priceIncludesTax\": true,\n      \"paymentMethodFamily\": \"card\",\n      \"paymentProcessorReference\": \"pi_10432\",\n      \"checkoutSessionId\": \"cs_10432\",\n      \"purchaseOrderNumber\": \"PO-10432\"\n    },\n    \"integrationOrderContext\": {\n      \"schemaVersion\": 1,\n      \"consumerIp\": \"203.0.113.10\",\n      \"salesCountryCode\": \"CO\",\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"salesPriceGrossMinor\": 2450,\n      \"salesPriceNetMinor\": 2450,\n      \"appliedDiscountPercentage\": 20,\n      \"appliedDiscountAmountMinor\": 2450,\n      \"immediateFulfilment\": true,\n      \"mustFulfil\": true,\n      \"buyerLocale\": \"de-DE\",\n      \"priceIncludesTax\": true,\n      \"salesTaxAmountMinor\": 2450,\n      \"salesTaxRatePercent\": 20,\n      \"customerVatNumber\": \"DE123456789\",\n      \"purchaseOrderNumber\": \"PO-10432\",\n      \"customerType\": \"b2c\",\n      \"paymentMethodFamily\": \"card\",\n      \"paymentProcessorReference\": \"pi_10432\",\n      \"checkoutSessionId\": \"cs_10432\",\n      \"salesChannel\": \"web\",\n      \"lineIndex\": 1,\n      \"parentOrderReference\": \"store-order-10432\",\n      \"externalNetworkOrderId\": \"142f2c61-b8b3-4afe-8542-28efa0740378\",\n      \"consumerIpHash\": \"3f9a1c7e2b4d6a80\",\n      \"consumerIpRedacted\": true\n    },\n    \"taxMetadata\": {\n      \"declaredTaxAmountMinor\": 2450,\n      \"declaredTaxRatePercent\": 20,\n      \"priceIncludesTax\": true,\n      \"authoritative\": false\n    },\n    \"settlement\": {\n      \"basis\": \"purchaser_country_capped\",\n      \"vatMinor\": 2450,\n      \"netMinor\": 2450,\n      \"appliedRatePercent\": 20,\n      \"declaredRatePercent\": 20,\n      \"evidenceRank\": 1,\n      \"requestedCountry\": \"DE\"\n    },\n    \"entryType\": \"sale\",\n    \"reversesTransactionId\": \"007d1078-f310-4096-8168-5c97487ad70f\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/api-sales/:transactionId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "api-sales",
                    ":transactionId"
                  ],
                  "variable": [
                    {
                      "key": "transactionId",
                      "value": "{{transactionId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Read one API sale transaction**\n\nOne sale as the ledger recorded it: what it settled at, which entry type it is, and, for a reversal, which sale it reverses. The list endpoint answers what happened this period; this answers why a statement line says what it does.\n\nA transaction id belonging to another seller returns 404 rather than 403, because a 403 would confirm the row exists.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/api-sales/{transactionId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"transactionId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Download a payout's reconciliation file",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/reconciliation?format=json",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "invoices",
                ":invoiceId",
                "reconciliation"
              ],
              "query": [
                {
                  "key": "format",
                  "value": "json",
                  "description": "`json` (default) or `csv`. enum: json, csv",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "invoiceId",
                  "value": "{{invoiceId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Download a payout's reconciliation file**\n\nThe reconciliation file for one payout: the vendor invoice you paid, every balance movement it settles and, under each movement, every API sale it covers (order reference, key id, gross, VAT, net and the publisher, seller and platform shares).\n\nMovement amounts are in minor units of the payment currency and add up to `totalCents`; sale amounts are in the sale currency as recorded on the sale, with `lineExchangeRate` the rate its report line converted at. The file is final once `paymentState` is `paid`; the `payout.file_ready` webhook fires then.\n\n`format=csv` returns one row per sale (a movement without sales gets one row of its own). `movementAmountCents` is written on the first row of each movement only, so summing the column gives the payout total.\n\nThe CSV's last two columns, `paymentCurrencyExponent` and `saleCurrencyExponent`, give the minor-unit digits of the payment and sale amounts (columns are only ever appended).\n\nAn invoice id that is not one of your payouts returns 404 rather than 403. On contract date `2026-12-01` and later, an invoice that is yours but has no settlement (an invoice of the earlier billing model, or one still waiting for the commission document) answers `409 CONFLICT` with `details.reason: RECONCILIATION_NOT_AVAILABLE` instead; `reconciliationAvailable` on the invoice tells you in advance. Earlier dates answer 404 for both.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/reconciliation`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The payout's reconciliation file.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/reconciliation?format=json",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId",
                    "reconciliation"
                  ],
                  "query": [
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. enum: json, csv",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Download a payout's reconciliation file**\n\nThe reconciliation file for one payout: the vendor invoice you paid, every balance movement it settles and, under each movement, every API sale it covers (order reference, key id, gross, VAT, net and the publisher, seller and platform shares).\n\nMovement amounts are in minor units of the payment currency and add up to `totalCents`; sale amounts are in the sale currency as recorded on the sale, with `lineExchangeRate` the rate its report line converted at. The file is final once `paymentState` is `paid`; the `payout.file_ready` webhook fires then.\n\n`format=csv` returns one row per sale (a movement without sales gets one row of its own). `movementAmountCents` is written on the first row of each movement only, so summing the column gives the payout total.\n\nThe CSV's last two columns, `paymentCurrencyExponent` and `saleCurrencyExponent`, give the minor-unit digits of the payment and sale amounts (columns are only ever appended).\n\nAn invoice id that is not one of your payouts returns 404 rather than 403. On contract date `2026-12-01` and later, an invoice that is yours but has no settlement (an invoice of the earlier billing model, or one still waiting for the commission document) answers `409 CONFLICT` with `details.reason: RECONCILIATION_NOT_AVAILABLE` instead; `reconciliationAvailable` on the invoice tells you in advance. Earlier dates answer 404 for both.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/reconciliation`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"invoiceId\": \"d9c14540-3062-4c40-811a-fa9ae9083921\",\n    \"invoiceNumber\": \"INV-2026-10-0042\",\n    \"settlementPackageId\": \"4cf0a96b-d91c-488d-8f79-78ee3f242dca\",\n    \"sellerCompanyId\": \"c61c807f-fcc4-4c77-849c-ec922d65634c\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"paymentCurrency\": \"EUR\",\n    \"paymentCurrencyExponent\": 2,\n    \"paymentState\": \"paid\",\n    \"paymentMethod\": \"wire_transfer\",\n    \"paymentReference\": \"NL-SEPA-2026-11-0042\",\n    \"settledAt\": \"2026-11-20T10:00:00Z\",\n    \"totalCents\": 1960,\n    \"totalMinor\": 1960,\n    \"saleCount\": 3,\n    \"movements\": [\n      {\n        \"movementId\": \"5a7c9e1b-3d5f-4a7b-9c1d-3e5f7a9b1c3d\",\n        \"movementType\": \"report_accrual\",\n        \"sourceType\": \"sales_report\",\n        \"amountCents\": 3920,\n        \"amountMinor\": 3920,\n        \"reportId\": \"7b9d1f3a-5c7e-4b9d-8f1a-3c5e7a9b1d3f\",\n        \"reportMonth\": \"2026-10\",\n        \"sales\": [\n          {\n            \"transactionId\": \"6f1c2a9e-3b7d-4e21-9c84-0a5d2e7b1f30\",\n            \"entryType\": \"sale\",\n            \"orderReference\": \"store-order-10432\",\n            \"keyId\": \"0e8f6a1b-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n            \"skuId\": \"58891c3c-0f7b-490c-830f-cc3ab1b3d391\",\n            \"saleTimestamp\": \"2026-10-04T14:12:09Z\",\n            \"currencyCode\": \"EUR\",\n            \"currencyExponent\": 2,\n            \"grossMinor\": 2450,\n            \"vatMinor\": 0,\n            \"netMinor\": 2450,\n            \"publisherShareMinor\": 1960,\n            \"sellerShareMinor\": 245,\n            \"platformFeeMinor\": 245,\n            \"lineExchangeRate\": 1,\n            \"adjustmentStatus\": \"refunded\"\n          },\n          {\n            \"transactionId\": \"8d2e4b6a-1c3f-4a57-b0e9-5f7a3c9d2e14\",\n            \"entryType\": \"sale\",\n            \"orderReference\": \"store-order-10432\",\n            \"keyId\": \"1f9a7b2c-3d4e-4f5a-9b0c-2d3e4f5a6b7c\",\n            \"skuId\": \"58891c3c-0f7b-490c-830f-cc3ab1b3d391\",\n            \"saleTimestamp\": \"2026-10-09T08:41:55Z\",\n            \"currencyCode\": \"EUR\",\n            \"currencyExponent\": 2,\n            \"grossMinor\": 2450,\n            \"vatMinor\": 0,\n            \"netMinor\": 2450,\n            \"publisherShareMinor\": 1960,\n            \"sellerShareMinor\": 245,\n            \"platformFeeMinor\": 245,\n            \"lineExchangeRate\": 1,\n            \"adjustmentStatus\": \"none\"\n          }\n        ]\n      },\n      {\n        \"movementId\": \"6b8d0f2c-4e6a-4b8c-8d0e-4f6a8b0c2d4e\",\n        \"movementType\": \"adjustment\",\n        \"sourceType\": \"api_sale_refund\",\n        \"amountCents\": -1960,\n        \"amountMinor\": -1960,\n        \"reportId\": null,\n        \"reportMonth\": null,\n        \"sales\": [\n          {\n            \"transactionId\": \"2b9f7c1d-6e4a-4f83-a2c5-9d1e8b3f7a60\",\n            \"entryType\": \"sale_reversal\",\n            \"orderReference\": \"store-order-10432\",\n            \"keyId\": \"0e8f6a1b-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n            \"skuId\": \"58891c3c-0f7b-490c-830f-cc3ab1b3d391\",\n            \"saleTimestamp\": \"2026-10-06T10:03:27Z\",\n            \"currencyCode\": \"EUR\",\n            \"currencyExponent\": 2,\n            \"grossMinor\": -2450,\n            \"vatMinor\": 0,\n            \"netMinor\": -2450,\n            \"publisherShareMinor\": -1960,\n            \"sellerShareMinor\": -245,\n            \"platformFeeMinor\": -245,\n            \"lineExchangeRate\": 1,\n            \"adjustmentStatus\": \"refunded\"\n          }\n        ]\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/reconciliation?format=json",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId",
                    "reconciliation"
                  ],
                  "query": [
                    {
                      "key": "format",
                      "value": "json",
                      "description": "`json` (default) or `csv`. enum: json, csv",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Download a payout's reconciliation file**\n\nThe reconciliation file for one payout: the vendor invoice you paid, every balance movement it settles and, under each movement, every API sale it covers (order reference, key id, gross, VAT, net and the publisher, seller and platform shares).\n\nMovement amounts are in minor units of the payment currency and add up to `totalCents`; sale amounts are in the sale currency as recorded on the sale, with `lineExchangeRate` the rate its report line converted at. The file is final once `paymentState` is `paid`; the `payout.file_ready` webhook fires then.\n\n`format=csv` returns one row per sale (a movement without sales gets one row of its own). `movementAmountCents` is written on the first row of each movement only, so summing the column gives the payout total.\n\nThe CSV's last two columns, `paymentCurrencyExponent` and `saleCurrencyExponent`, give the minor-unit digits of the payment and sale amounts (columns are only ever appended).\n\nAn invoice id that is not one of your payouts returns 404 rather than 403. On contract date `2026-12-01` and later, an invoice that is yours but has no settlement (an invoice of the earlier billing model, or one still waiting for the commission document) answers `409 CONFLICT` with `details.reason: RECONCILIATION_NOT_AVAILABLE` instead; `reconciliationAvailable` on the invoice tells you in advance. Earlier dates answer 404 for both.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/reconciliation`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"invoiceId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get an invoice you owe",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "invoices",
                ":invoiceId"
              ],
              "variable": [
                {
                  "key": "invoiceId",
                  "value": "{{invoiceId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get an invoice you owe**\n\nOne invoice with what it bills (`lines`, one per balance movement), the settlement that pays it (`payment`), payments recorded against an invoice of the earlier billing model (`paymentRecords`), your disputes, the document to download, and its history. The id is the one every `invoice.*` event carries.\n\nAn invoice that is not yours, or not yet issued, answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The invoice.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId"
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get an invoice you owe**\n\nOne invoice with what it bills (`lines`, one per balance movement), the settlement that pays it (`payment`), payments recorded against an invoice of the earlier billing model (`paymentRecords`), your disputes, the document to download, and its history. The id is the one every `invoice.*` event carries.\n\nAn invoice that is not yours, or not yet issued, answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"f0674f47-5753-40ea-8f6b-8eada648f27a\",\n    \"invoiceNumber\": \"INV-2026-10-0042\",\n    \"status\": \"awaiting_commission_document\",\n    \"invoiceType\": \"final\",\n    \"totalCents\": 2450,\n    \"totalMinor\": 2450,\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"issuedAt\": \"2026-11-02T09:30:00Z\",\n    \"dueAt\": \"2026-11-02T09:30:00Z\",\n    \"salesReportId\": \"d5485d46-3454-4757-838b-e6fc09d6fab4\",\n    \"paidAt\": \"2026-11-02T09:30:00Z\",\n    \"kind\": \"vendor_payable\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"supplierInvoiceNumber\": \"example_supplierinvoicenumber\",\n    \"reportMonth\": \"2026-10\",\n    \"subtotalCents\": 2450,\n    \"subtotalMinor\": 2450,\n    \"taxCents\": 2450,\n    \"taxMinor\": 2450,\n    \"paidCents\": 2450,\n    \"paidMinor\": 2450,\n    \"outstandingCents\": 2450,\n    \"outstandingMinor\": 2450,\n    \"paymentTermsDays\": 1,\n    \"paymentState\": \"unpaid\",\n    \"replacesInvoiceId\": \"84fee5cc-4fb5-40ed-8502-3c88b84a8c05\",\n    \"supersededByInvoiceId\": \"0979ad81-9eae-4fec-855b-7cdd276d5b1e\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"reconciliationAvailable\": true,\n    \"reconciliationPath\": \"example_reconciliationpath\",\n    \"detailPath\": \"example_detailpath\",\n    \"lines\": [\n      {\n        \"allocationId\": \"75440ab8-54f1-4dd4-8d12-1d411835e81f\",\n        \"movementId\": \"14621c88-8345-4383-8d99-00611e4191fb\",\n        \"movementType\": \"report_accrual\",\n        \"sourceType\": \"sales_report\",\n        \"reportId\": \"fa852f64-0efd-46f5-834a-ee95375adae5\",\n        \"reportMonth\": \"2026-10\",\n        \"contractTermId\": \"73602396-3ca3-4058-8a3f-56662dc34dcc\",\n        \"amountCents\": 2450,\n        \"amountMinor\": 2450,\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2\n      }\n    ],\n    \"payment\": {\n      \"paymentState\": \"unpaid\",\n      \"paymentMethod\": \"wire_transfer\",\n      \"paymentReference\": \"example_paymentreference\",\n      \"amountCents\": 2450,\n      \"amountMinor\": 2450,\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"dueAt\": \"2026-11-02T09:30:00Z\",\n      \"settledAt\": \"2026-11-02T09:30:00Z\"\n    },\n    \"paymentRecords\": [\n      {\n        \"paymentRecordId\": \"d015c72a-71af-436b-8590-7996b41e0151\",\n        \"paymentType\": \"wire_transfer\",\n        \"status\": \"pending\",\n        \"amountCents\": 2450,\n        \"amountMinor\": 2450,\n        \"currencyCode\": \"EUR\",\n        \"currencyExponent\": 2,\n        \"bankReference\": \"example_bankreference\",\n        \"paymentDate\": \"2026-11-02T09:30:00Z\",\n        \"confirmedAt\": \"2026-11-02T09:30:00Z\",\n        \"createdAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"disputes\": [\n      {\n        \"disputeId\": \"588c65a8-ed47-4075-8546-6f656fbb884e\",\n        \"status\": \"open\",\n        \"reasonCode\": \"amount_mismatch\",\n        \"explanation\": \"example_explanation\",\n        \"vendorResponse\": \"example_vendorresponse\",\n        \"raisedAt\": \"2026-11-02T09:30:00Z\",\n        \"respondedAt\": \"2026-11-02T09:30:00Z\",\n        \"resolvedAt\": \"2026-11-02T09:30:00Z\",\n        \"replacementInvoiceId\": \"2557b374-c889-4b5c-82b4-9cc62c974940\"\n      }\n    ],\n    \"documents\": [\n      {\n        \"documentId\": \"7c3c682a-1b99-48c8-892d-0b997e5fed09\",\n        \"fileName\": \"Example name\",\n        \"byteSize\": 1,\n        \"contentHash\": \"example_contenthash\",\n        \"origin\": \"example_origin\",\n        \"frozenAt\": \"2026-11-02T09:30:00Z\",\n        \"createdAt\": \"2026-11-02T09:30:00Z\",\n        \"downloadPath\": \"example_downloadpath\"\n      }\n    ],\n    \"history\": [\n      {\n        \"eventType\": \"issued\",\n        \"occurredAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId"
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get an invoice you owe**\n\nOne invoice with what it bills (`lines`, one per balance movement), the settlement that pays it (`payment`), payments recorded against an invoice of the earlier billing model (`paymentRecords`), your disputes, the document to download, and its history. The id is the one every `invoice.*` event carries.\n\nAn invoice that is not yours, or not yet issued, answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"invoiceId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get a download link for an invoice document",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/document",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "invoices",
                ":invoiceId",
                "document"
              ],
              "variable": [
                {
                  "key": "invoiceId",
                  "value": "{{invoiceId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get a download link for an invoice document**\n\nA signed link to the invoice document the vendor issued to you, the same file the console offers. The link works without your API key for five minutes (`expiresAt`); ask again for a fresh one. Check the file against `contentHash`.\n\n404 when the invoice is not yours, and also when it has no document you can download (invoices of the earlier billing model); then `details.reason` is `no_document`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/document`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 A short-lived download link.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId",
                    "document"
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a download link for an invoice document**\n\nA signed link to the invoice document the vendor issued to you, the same file the console offers. The link works without your API key for five minutes (`expiresAt`); ask again for a fresh one. Check the file against `contentHash`.\n\n404 when the invoice is not yours, and also when it has no document you can download (invoices of the earlier billing model); then `details.reason` is `no_document`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/document`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"invoiceId\": \"39870f59-424d-464e-891d-a7cc37ab0864\",\n    \"documentId\": \"08e33a09-eaaa-46fe-8650-386a08faaef7\",\n    \"fileName\": \"Example name\",\n    \"byteSize\": 1,\n    \"contentHash\": \"example_contenthash\",\n    \"contentType\": \"application/pdf\",\n    \"url\": \"https://api.avrix.io/api/seller/v1/example\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/invoices/:invoiceId/document",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "invoices",
                    ":invoiceId",
                    "document"
                  ],
                  "variable": [
                    {
                      "key": "invoiceId",
                      "value": "{{invoiceId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a download link for an invoice document**\n\nA signed link to the invoice document the vendor issued to you, the same file the console offers. The link works without your API key for five minutes (`expiresAt`); ask again for a fresh one. Check the file against `contentHash`.\n\n404 when the invoice is not yours, and also when it has no document you can download (invoices of the earlier billing model); then `details.reason` is `no_document`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/invoices/{invoiceId}/document`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"invoiceId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List your invoice payments",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/payments?limit=50&cursor=&paymentState=unpaid%2Cin_progress&invoiceId=&publisherCompanyId=&settledFrom=&settledTo=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "payments"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "paymentState",
                  "value": "unpaid,in_progress",
                  "description": "Only settlements in these states. Comma-separated; any of: `unpaid`, `in_progress`, `paid`, `reversed`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "invoiceId",
                  "value": "",
                  "description": "Only the settlement of this invoice. (UUID)",
                  "disabled": true
                },
                {
                  "key": "publisherCompanyId",
                  "value": "",
                  "description": "Only settlements with this vendor.",
                  "disabled": true
                },
                {
                  "key": "settledFrom",
                  "value": "",
                  "description": "Settled at or after this instant. (ISO 8601)",
                  "disabled": true
                },
                {
                  "key": "settledTo",
                  "value": "",
                  "description": "Settled before this instant. (ISO 8601)",
                  "disabled": true
                }
              ]
            },
            "description": "**List your invoice payments**\n\nYour side of each vendor invoice's settlement, newest first: what you pay, by which method and reference, whether it is paid and when it cleared. One row per invoice that has a settlement (`invoiceId`). The commission the vendor pays Avrix is the vendor's and is not shown.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/payments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Settlements and pagination meta.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/payments?limit=50&cursor=&paymentState=unpaid%2Cin_progress&invoiceId=&publisherCompanyId=&settledFrom=&settledTo=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "payments"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "paymentState",
                      "value": "unpaid,in_progress",
                      "description": "Only settlements in these states. Comma-separated; any of: `unpaid`, `in_progress`, `paid`, `reversed`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "invoiceId",
                      "value": "",
                      "description": "Only the settlement of this invoice. (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only settlements with this vendor.",
                      "disabled": true
                    },
                    {
                      "key": "settledFrom",
                      "value": "",
                      "description": "Settled at or after this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "settledTo",
                      "value": "",
                      "description": "Settled before this instant. (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List your invoice payments**\n\nYour side of each vendor invoice's settlement, newest first: what you pay, by which method and reference, whether it is paid and when it cleared. One row per invoice that has a settlement (`invoiceId`). The commission the vendor pays Avrix is the vendor's and is not shown.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/payments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"paymentId\": \"4a682301-0fb0-46ea-8187-b40581e6f645\",\n      \"invoiceId\": \"cad747be-6f05-4f1d-8448-bc19e264461d\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"amountCents\": 2450,\n      \"amountMinor\": 2450,\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"paymentState\": \"unpaid\",\n      \"paymentMethod\": null,\n      \"paymentReference\": \"example_paymentreference\",\n      \"dueAt\": \"2026-11-02T09:30:00Z\",\n      \"settledAt\": \"2026-11-02T09:30:00Z\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"invoicePath\": \"example_invoicepath\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/payments?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/payments?limit=50&cursor=&paymentState=unpaid%2Cin_progress&invoiceId=&publisherCompanyId=&settledFrom=&settledTo=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "payments"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "paymentState",
                      "value": "unpaid,in_progress",
                      "description": "Only settlements in these states. Comma-separated; any of: `unpaid`, `in_progress`, `paid`, `reversed`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "invoiceId",
                      "value": "",
                      "description": "Only the settlement of this invoice. (UUID)",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only settlements with this vendor.",
                      "disabled": true
                    },
                    {
                      "key": "settledFrom",
                      "value": "",
                      "description": "Settled at or after this instant. (ISO 8601)",
                      "disabled": true
                    },
                    {
                      "key": "settledTo",
                      "value": "",
                      "description": "Settled before this instant. (ISO 8601)",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List your invoice payments**\n\nYour side of each vendor invoice's settlement, newest first: what you pay, by which method and reference, whether it is paid and when it cleared. One row per invoice that has a settlement (`invoiceId`). The commission the vendor pays Avrix is the vendor's and is not shown.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/payments`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List your monthly sales reports",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/reports?limit=50&cursor=&status=draft%2Coverdue&modelType=api%2Crevenue_share&reportMonth=&publisherCompanyId=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "reports"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "draft,overdue",
                  "description": "Only reports in these states. Comma-separated; any of: `draft`, `overdue`, `submitted`, `approved`, `disputed`, `rejected`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "modelType",
                  "value": "api,revenue_share",
                  "description": "Only reports of these models. Comma-separated; any of: `api`, `revenue_share`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                },
                {
                  "key": "reportMonth",
                  "value": "",
                  "description": "Only reports for this month, `YYYY-MM`.",
                  "disabled": true
                },
                {
                  "key": "publisherCompanyId",
                  "value": "",
                  "description": "Only reports with this vendor.",
                  "disabled": true
                }
              ]
            },
            "description": "**List your monthly sales reports**\n\nYour monthly sales reports, newest first: one per vendor and month, with totals in minor units and where each stands (`confirmation`). The `report.ready` event names a report; read it here. An approved report is what the vendor's monthly invoice bills.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Reports and pagination meta.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports?limit=50&cursor=&status=draft%2Coverdue&modelType=api%2Crevenue_share&reportMonth=&publisherCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "draft,overdue",
                      "description": "Only reports in these states. Comma-separated; any of: `draft`, `overdue`, `submitted`, `approved`, `disputed`, `rejected`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "modelType",
                      "value": "api,revenue_share",
                      "description": "Only reports of these models. Comma-separated; any of: `api`, `revenue_share`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "reportMonth",
                      "value": "",
                      "description": "Only reports for this month, `YYYY-MM`.",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only reports with this vendor.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List your monthly sales reports**\n\nYour monthly sales reports, newest first: one per vendor and month, with totals in minor units and where each stands (`confirmation`). The `report.ready` event names a report; read it here. An approved report is what the vendor's monthly invoice bills.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"e265878b-0000-465f-8716-bec11344c28e\",\n      \"reportMonth\": \"2026-10\",\n      \"status\": \"draft\",\n      \"modelType\": \"api\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"periodStart\": \"2026-10-01T00:00:00Z\",\n      \"periodEnd\": \"2026-10-31T23:59:59Z\",\n      \"deadline\": \"example_deadline\",\n      \"submittedAt\": \"2026-11-02T09:30:00Z\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"updatedAt\": \"2026-11-02T09:30:00Z\",\n      \"revokedAt\": \"2026-11-02T09:30:00Z\",\n      \"totals\": {\n        \"grossCents\": 2450,\n        \"grossMinor\": 2450,\n        \"netCents\": 2450,\n        \"netMinor\": 2450,\n        \"reversalsCents\": 2450,\n        \"reversalsMinor\": 2450,\n        \"vatCents\": 2450,\n        \"vatMinor\": 2450,\n        \"sellerShareCents\": 2450,\n        \"sellerShareMinor\": 2450,\n        \"publisherShareCents\": 2450,\n        \"publisherShareMinor\": 2450\n      },\n      \"confirmation\": {\n        \"state\": \"awaiting_seller\",\n        \"nextActor\": \"seller\",\n        \"deadline\": \"example_deadline\",\n        \"overdue\": true,\n        \"submittedAt\": \"2026-11-02T09:30:00Z\",\n        \"confirmIn\": \"console\"\n      },\n      \"detailPath\": \"example_detailpath\",\n      \"linesPath\": \"example_linespath\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/reports?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports?limit=50&cursor=&status=draft%2Coverdue&modelType=api%2Crevenue_share&reportMonth=&publisherCompanyId=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "draft,overdue",
                      "description": "Only reports in these states. Comma-separated; any of: `draft`, `overdue`, `submitted`, `approved`, `disputed`, `rejected`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "modelType",
                      "value": "api,revenue_share",
                      "description": "Only reports of these models. Comma-separated; any of: `api`, `revenue_share`. An unknown value is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    },
                    {
                      "key": "reportMonth",
                      "value": "",
                      "description": "Only reports for this month, `YYYY-MM`.",
                      "disabled": true
                    },
                    {
                      "key": "publisherCompanyId",
                      "value": "",
                      "description": "Only reports with this vendor.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List your monthly sales reports**\n\nYour monthly sales reports, newest first: one per vendor and month, with totals in minor units and where each stands (`confirmation`). The `report.ready` event names a report; read it here. An approved report is what the vendor's monthly invoice bills.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED` on every contract date.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Get a monthly sales report",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "reports",
                ":reportId"
              ],
              "variable": [
                {
                  "key": "reportId",
                  "value": "{{reportId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get a monthly sales report**\n\nOne monthly report: totals in minor units of its currency, the exchange rates it froze and the convention that chose them (`fx`), any rates you attested, its confirmation state and deadline, and disputes. The lines are on `GET /finance/reports/{reportId}/lines`.\n\nA report that is not yours answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The report.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports",
                    ":reportId"
                  ],
                  "variable": [
                    {
                      "key": "reportId",
                      "value": "{{reportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a monthly sales report**\n\nOne monthly report: totals in minor units of its currency, the exchange rates it froze and the convention that chose them (`fx`), any rates you attested, its confirmation state and deadline, and disputes. The lines are on `GET /finance/reports/{reportId}/lines`.\n\nA report that is not yours answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"f510b4db-800c-4579-8793-0c20f79f77c1\",\n    \"reportMonth\": \"2026-10\",\n    \"status\": \"draft\",\n    \"modelType\": \"api\",\n    \"publisherCompanyId\": \"acme-games\",\n    \"currencyCode\": \"EUR\",\n    \"currencyExponent\": 2,\n    \"periodStart\": \"2026-10-01T00:00:00Z\",\n    \"periodEnd\": \"2026-10-31T23:59:59Z\",\n    \"deadline\": \"example_deadline\",\n    \"submittedAt\": \"2026-11-02T09:30:00Z\",\n    \"createdAt\": \"2026-11-02T09:30:00Z\",\n    \"updatedAt\": \"2026-11-02T09:30:00Z\",\n    \"revokedAt\": \"2026-11-02T09:30:00Z\",\n    \"totals\": {\n      \"grossCents\": 2450,\n      \"grossMinor\": 2450,\n      \"netCents\": 2450,\n      \"netMinor\": 2450,\n      \"reversalsCents\": 2450,\n      \"reversalsMinor\": 2450,\n      \"vatCents\": 2450,\n      \"vatMinor\": 2450,\n      \"sellerShareCents\": 2450,\n      \"sellerShareMinor\": 2450,\n      \"publisherShareCents\": 2450,\n      \"publisherShareMinor\": 2450\n    },\n    \"confirmation\": {\n      \"state\": \"awaiting_seller\",\n      \"nextActor\": \"seller\",\n      \"deadline\": \"example_deadline\",\n      \"overdue\": true,\n      \"submittedAt\": \"2026-11-02T09:30:00Z\",\n      \"confirmIn\": \"console\"\n    },\n    \"detailPath\": \"example_detailpath\",\n    \"linesPath\": \"example_linespath\",\n    \"rejectionReason\": null,\n    \"fxConvention\": \"example_fxconvention\",\n    \"fx\": [\n      {\n        \"saleCurrency\": \"EUR\",\n        \"reportCurrency\": \"EUR\",\n        \"rate\": \"example_rate\",\n        \"source\": \"identity\",\n        \"asOf\": \"example_asof\",\n        \"fixingTime\": \"2026-11-02T09:30:00Z\",\n        \"convention\": \"example_convention\",\n        \"identity\": true\n      }\n    ],\n    \"fxAttestations\": [\n      {\n        \"sourceCurrency\": \"EUR\",\n        \"paymentCurrency\": \"EUR\",\n        \"rate\": \"example_rate\",\n        \"note\": \"Example text.\",\n        \"attestedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ],\n    \"disputes\": [\n      {\n        \"disputeId\": \"ce583771-e6c3-4b40-85fb-23b2bbe4da44\",\n        \"status\": \"active\",\n        \"reason\": null,\n        \"filedByCompanyId\": \"036115c2-4593-4c06-8d8b-ab835f30dd17\",\n        \"filedAt\": \"2026-11-02T09:30:00Z\",\n        \"resolvedAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports",
                    ":reportId"
                  ],
                  "variable": [
                    {
                      "key": "reportId",
                      "value": "{{reportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a monthly sales report**\n\nOne monthly report: totals in minor units of its currency, the exchange rates it froze and the convention that chose them (`fx`), any rates you attested, its confirmation state and deadline, and disputes. The lines are on `GET /finance/reports/{reportId}/lines`.\n\nA report that is not yours answers 404.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"reportId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — List the lines of a monthly sales report",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId/lines?limit=50&cursor=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "finance",
                "reports",
                ":reportId",
                "lines"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "reportId",
                  "value": "{{reportId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**List the lines of a monthly sales report**\n\nThe lines of one report, paged: per product and sale currency, the sale amounts in `saleCurrency`, the rate used, and both shares in the report currency.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}/lines`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Report lines and pagination meta.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId/lines?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports",
                    ":reportId",
                    "lines"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "reportId",
                      "value": "{{reportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List the lines of a monthly sales report**\n\nThe lines of one report, paged: per product and sale currency, the sale amounts in `saleCurrency`, the rate used, and both shares in the report currency.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}/lines`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"lineId\": \"fecf3e85-611e-46d5-8f42-a01a0364be30\",\n      \"entryType\": \"sale\",\n      \"skuId\": \"22292467-0af3-40a5-853f-827f1a0a6ded\",\n      \"productId\": \"3e403ca5-4577-4dd8-80a1-744c133b5df3\",\n      \"publisherCompanyId\": \"acme-games\",\n      \"quantity\": 12,\n      \"saleCurrency\": \"EUR\",\n      \"saleCurrencyExponent\": 2,\n      \"unitPriceCents\": 2450,\n      \"unitPriceMinor\": 2450,\n      \"grossCents\": 2450,\n      \"grossMinor\": 2450,\n      \"netCents\": 2450,\n      \"netMinor\": 2450,\n      \"vatCents\": 2450,\n      \"vatMinor\": 2450,\n      \"deductionsCents\": 2450,\n      \"deductionsMinor\": 2450,\n      \"currencyCode\": \"EUR\",\n      \"currencyExponent\": 2,\n      \"exchangeRate\": \"example_exchangerate\",\n      \"netConvertedCents\": 2450,\n      \"netConvertedMinor\": 2450,\n      \"publisherShareCents\": 2450,\n      \"publisherShareMinor\": 2450,\n      \"sellerShareCents\": 2450,\n      \"sellerShareMinor\": 2450,\n      \"appliedRatePercent\": 20,\n      \"region\": \"EU\",\n      \"requestedCountry\": \"DE\",\n      \"platform\": \"steam\",\n      \"promotionLabel\": \"example_promotionlabel\",\n      \"promotionReference\": \"example_promotionreference\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2450,\n    \"limit\": 50,\n    \"hasMore\": true,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/finance/reports/5da9bbcf-350e-45a0-8e09-b66de7ddc0ce/lines?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"localePreference\": \"en\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/finance/reports/:reportId/lines?limit=50&cursor=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "finance",
                    "reports",
                    ":reportId",
                    "lines"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque position from `meta.nextCursor`; omit it on the first call. A value this API did not return is refused with `422 VALIDATION_FAILED`.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "reportId",
                      "value": "{{reportId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**List the lines of a monthly sales report**\n\nThe lines of one report, paged: per product and sale currency, the sale amounts in `saleCurrency`, the rate used, and both shares in the report currency.\n\nPaging: the shared list contract (`https://docs.avrix.io/seller-api/pagination`). A `cursor` this API did not return is refused with `422 VALIDATION_FAILED`.\n\n**Scopes:** `seller:finance:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/finance/reports/{reportId}/lines`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"reportId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Regions",
      "description": "Supported sales regions and per-region rules. Reference data; safe to cache.",
      "item": [
        {
          "name": "GET — List regions visible to seller",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/regions?limit=50&cursor=&partner=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "regions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                  "disabled": true
                },
                {
                  "key": "partner",
                  "value": "",
                  "description": "Deprecated: accepted and ignored. It never filtered the result.",
                  "disabled": true
                }
              ]
            },
            "description": "**List regions visible to seller**\n\nThe sales regions of the SKUs you hold an active allocation for. `allowedCountries` lists the countries that make up each region. A release can exclude some of them: what a given release may be sold in is `releases[].allowedCountries` on `GET /products/{productId}`, and that is what the order checks use.\n\n**Not paginated:** the response is the complete list, with no `meta`. `limit`, `cursor` and `partner` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Regions visible via active allocations (`{ data: SellerRegionSummary[] }`).",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/regions?limit=50&cursor=&partner=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "regions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                      "disabled": true
                    },
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. It never filtered the result.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List regions visible to seller**\n\nThe sales regions of the SKUs you hold an active allocation for. `allowedCountries` lists the countries that make up each region. A release can exclude some of them: what a given release may be sold in is `releases[].allowedCountries` on `GET /products/{productId}`, and that is what the order checks use.\n\n**Not paginated:** the response is the complete list, with no `meta`. `limit`, `cursor` and `partner` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"code\": \"EU\",\n      \"name\": \"Example Game\",\n      \"allowedCountries\": [\n        \"DE\"\n      ],\n      \"deniedCountries\": [\n        \"DE\"\n      ]\n    }\n  ]\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/regions?limit=50&cursor=&partner=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "regions"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list. (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. This operation is not paged and always returns the complete list.",
                      "disabled": true
                    },
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. It never filtered the result.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List regions visible to seller**\n\nThe sales regions of the SKUs you hold an active allocation for. `allowedCountries` lists the countries that make up each region. A release can exclude some of them: what a given release may be sold in is `releases[].allowedCountries` on `GET /products/{productId}`, and that is what the order checks use.\n\n**Not paginated:** the response is the complete list, with no `meta`. `limit`, `cursor` and `partner` are deprecated: they were never read, and a request that sends them is answered as if they were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Region detail",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/regions/:code?partner=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "regions",
                ":code"
              ],
              "query": [
                {
                  "key": "partner",
                  "value": "",
                  "description": "Deprecated: accepted and ignored. It never filtered the result.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "{{code}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Region detail**\n\nOne region by its code (case-insensitive), when it is among the regions returned by `GET /regions`. **404** `NOT_FOUND` when the region does not exist or none of your active allocations is in it.\n\n`partner` is deprecated: it was never read, and a request that sends it is answered as if it were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions/{code}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Region detail",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/regions/:code?partner=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "regions",
                    ":code"
                  ],
                  "query": [
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. It never filtered the result.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "code",
                      "value": "{{code}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Region detail**\n\nOne region by its code (case-insensitive), when it is among the regions returned by `GET /regions`. **404** `NOT_FOUND` when the region does not exist or none of your active allocations is in it.\n\n`partner` is deprecated: it was never read, and a request that sends it is answered as if it were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions/{code}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"code\": \"EU\",\n    \"name\": \"Example Game\",\n    \"allowedCountries\": [\n      \"DE\"\n    ],\n    \"deniedCountries\": [\n      \"DE\"\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/regions/:code?partner=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "regions",
                    ":code"
                  ],
                  "query": [
                    {
                      "key": "partner",
                      "value": "",
                      "description": "Deprecated: accepted and ignored. It never filtered the result.",
                      "disabled": true
                    }
                  ],
                  "variable": [
                    {
                      "key": "code",
                      "value": "{{code}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Region detail**\n\nOne region by its code (case-insensitive), when it is among the regions returned by `GET /regions`. **404** `NOT_FOUND` when the region does not exist or none of your active allocations is in it.\n\n`partner` is deprecated: it was never read, and a request that sends it is answered as if it were absent.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/regions/{code}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"code\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Platforms",
      "description": "Distribution platforms (Steam, Epic, …) referenced by SKUs. Reference data; safe to cache.",
      "item": [
        {
          "name": "GET — Platform registry",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/platforms",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "platforms"
              ]
            },
            "description": "**Platform registry**\n\nReference list of platform codes (`steam`, `ps5`, …) with display names and platform families, so integrators can validate `platformCode` values offline instead of treating them as open strings. Mirrors `GET /regions`; safe to cache for an hour.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/platforms`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Active platforms",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/platforms",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "platforms"
                  ]
                },
                "description": "**Platform registry**\n\nReference list of platform codes (`steam`, `ps5`, …) with display names and platform families, so integrators can validate `platformCode` values offline instead of treating them as open strings. Mirrors `GET /regions`; safe to cache for an hour.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/platforms`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"code\": \"steam\",\n      \"name\": \"Example Game\",\n      \"platformFamily\": \"steam\"\n    }\n  ],\n  \"version\": \"1\",\n  \"updatedAt\": \"2026-11-02T09:30:00Z\"\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/platforms",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "platforms"
                  ]
                },
                "description": "**Platform registry**\n\nReference list of platform codes (`steam`, `ps5`, …) with display names and platform families, so integrators can validate `platformCode` values offline instead of treating them as open strings. Mirrors `GET /regions`; safe to cache for an hour.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `catalog`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/platforms`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Integration",
      "description": "Integration readiness for the authenticated seller — use when triaging onboarding.",
      "item": [
        {
          "name": "GET — Integration status",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/integration/status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "integration",
                "status"
              ]
            },
            "description": "**Integration status**\n\nConsolidated onboarding progress — one machine-readable answer to \"why can't I sell yet?\". Each gate (BMA, catalog share, allocation, territory pricing, webhook, signed test ping, first order) reports `satisfied` plus an actionable `hint`. `readyToSell` is true when every commerce-critical gate passes. Diagnostics-grade endpoint: poll during onboarding, not on the hot path.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/integration/status`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Consolidated integration gates",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/integration/status",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "integration",
                    "status"
                  ]
                },
                "description": "**Integration status**\n\nConsolidated onboarding progress — one machine-readable answer to \"why can't I sell yet?\". Each gate (BMA, catalog share, allocation, territory pricing, webhook, signed test ping, first order) reports `satisfied` plus an actionable `hint`. `readyToSell` is true when every commerce-critical gate passes. Diagnostics-grade endpoint: poll during onboarding, not on the hot path.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/integration/status`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"readyToSell\": true,\n    \"gates\": [\n      {\n        \"gate\": \"bmaActive\",\n        \"satisfied\": true,\n        \"hint\": \"Example text.\"\n      }\n    ],\n    \"counts\": {\n      \"sellableSkuCount\": 12,\n      \"sharedSkuCount\": 12,\n      \"allocatedSkuCount\": 12\n    },\n    \"activationPolicy\": \"warn\",\n    \"activationEnforceOptIn\": true,\n    \"priceCommitmentConfigured\": true,\n    \"backorderEnabled\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/integration/status",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "integration",
                    "status"
                  ]
                },
                "description": "**Integration status**\n\nConsolidated onboarding progress — one machine-readable answer to \"why can't I sell yet?\". Each gate (BMA, catalog share, allocation, territory pricing, webhook, signed test ping, first order) reports `satisfied` plus an actionable `hint`. `readyToSell` is true when every commerce-critical gate passes. Diagnostics-grade endpoint: poll during onboarding, not on the hot path.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/integration/status`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Geo",
      "description": "Buyer geo-attestation: open an attestation, serve the pixel, and complete it. Used for sanctioned-geo controls.",
      "item": [
        {
          "name": "POST — Create a buyer network confirmation",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/geo/attest",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "geo",
                "attest"
              ]
            },
            "description": "**Create a buyer network confirmation**\n\nMints a short-lived confirmation the storefront loads in the buyer browser. Requires any seller scope. Sandbox keys never require this on orders.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "201 Attest created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest"
                  ]
                },
                "description": "**Create a buyer network confirmation**\n\nMints a short-lived confirmation the storefront loads in the buyer browser. Requires any seller scope. Sandbox keys never require this on orders.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"attestId\": \"9cb5ed4c-feaf-4583-8dc6-7224202f31f8\",\n    \"expiresAt\": \"2026-11-02T09:30:00Z\",\n    \"pixelUrl\": \"https://api.avrix.io/api/seller/v1/example\"\n  },\n  \"meta\": {}\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest"
                  ]
                },
                "description": "**Create a buyer network confirmation**\n\nMints a short-lived confirmation the storefront loads in the buyer browser. Requires any seller scope. Sandbox keys never require this on orders.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Read a buyer network confirmation",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "geo",
                "attest",
                ":attestId"
              ],
              "variable": [
                {
                  "key": "attestId",
                  "value": "{{attestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Read a buyer network confirmation**\n\nWhere a buyer network confirmation (`POST /geo/attest`) stands, so your checkout can tell whether the pixel has loaded before it sends `consumerGeoAttestId`. `pending` until the buyer's browser loads the pixel; `completed` once it did and the confirmation can be used; `consumed` after an order spent it; `expired` after `expiresAt`; `store_server` when the pixel loaded from an address on your key's allowlist, which is refused (mint a new one from the checkout page).\n\nOnly the key that created the confirmation can read it; any other id answers **404** `NOT_FOUND`. Any key scope. Nothing about the buyer (address, country) is returned.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Confirmation status",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Read a buyer network confirmation**\n\nWhere a buyer network confirmation (`POST /geo/attest`) stands, so your checkout can tell whether the pixel has loaded before it sends `consumerGeoAttestId`. `pending` until the buyer's browser loads the pixel; `completed` once it did and the confirmation can be used; `consumed` after an order spent it; `expired` after `expiresAt`; `store_server` when the pixel loaded from an address on your key's allowlist, which is refused (mint a new one from the checkout page).\n\nOnly the key that created the confirmation can read it; any other id answers **404** `NOT_FOUND`. Any key scope. Nothing about the buyer (address, country) is returned.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"attestId\": \"7e1d3c5b-9a8f-4e6d-8c2b-0a1f2e3d4c5b\",\n    \"status\": \"completed\",\n    \"expiresAt\": \"2026-12-02T09:45:00.000Z\",\n    \"completedAt\": \"2026-12-02T09:31:12.000Z\",\n    \"consumedAt\": null,\n    \"consumedOrderReference\": null\n  },\n  \"meta\": {\n    \"requestId\": \"req_7f3a91c2\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Read a buyer network confirmation**\n\nWhere a buyer network confirmation (`POST /geo/attest`) stands, so your checkout can tell whether the pixel has loaded before it sends `consumerGeoAttestId`. `pending` until the buyer's browser loads the pixel; `completed` once it did and the confirmation can be used; `consumed` after an order spent it; `expired` after `expiresAt`; `store_server` when the pixel loaded from an address on your key's allowlist, which is refused (mint a new one from the checkout page).\n\nOnly the key that created the confirmation can read it; any other id answers **404** `NOT_FOUND`. Any key scope. Nothing about the buyer (address, country) is returned.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"attestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "GET — Complete buyer network confirmation (pixel)",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/pixel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "geo",
                "attest",
                ":attestId",
                "pixel"
              ],
              "variable": [
                {
                  "key": "attestId",
                  "value": "{{attestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Complete buyer network confirmation (pixel)**\n\nNo API key. Intended for the buyer browser. Returns a 1×1 GIF. CORS `*`. Always answers 200 with the image, whatever happened to the confirmation, so read the outcome from your next preview, hold or order. The response carries the standard `X-Request-Id`, `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`. Completing from the store server is rejected later as CONSUMER_IP_INVALID.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}/pixel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 1×1 GIF (completion is best-effort)",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/pixel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId",
                    "pixel"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Complete buyer network confirmation (pixel)**\n\nNo API key. Intended for the buyer browser. Returns a 1×1 GIF. CORS `*`. Always answers 200 with the image, whatever happened to the confirmation, so read the outcome from your next preview, hold or order. The response carries the standard `X-Request-Id`, `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`. Completing from the store server is rejected later as CONSUMER_IP_INVALID.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}/pixel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/pixel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId",
                    "pixel"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Complete buyer network confirmation (pixel)**\n\nNo API key. Intended for the buyer browser. Returns a 1×1 GIF. CORS `*`. Always answers 200 with the image, whatever happened to the confirmation, so read the outcome from your next preview, hold or order. The response carries the standard `X-Request-Id`, `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`. Completing from the store server is rejected later as CONSUMER_IP_INVALID.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 429, 500\n\n**Path:** `GET /api/seller/v1/geo/attest/{attestId}/pixel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"attestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Complete buyer network confirmation (JSON)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/complete",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "geo",
                "attest",
                ":attestId",
                "complete"
              ],
              "variable": [
                {
                  "key": "attestId",
                  "value": "{{attestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Complete buyer network confirmation (JSON)**\n\nNo API key. Same effect as the pixel, with a JSON body. CORS `*`. Every response carries the standard `X-Request-Id` (equal to the body's `requestId`), `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`; a `429`, `503` or `504` also carries `Retry-After`.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest/{attestId}/complete`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "auth": {
              "type": "noauth"
            }
          },
          "response": [
            {
              "name": "200 Completed",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/complete",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId",
                    "complete"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Complete buyer network confirmation (JSON)**\n\nNo API key. Same effect as the pixel, with a JSON body. CORS `*`. Every response carries the standard `X-Request-Id` (equal to the body's `requestId`), `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`; a `429`, `503` or `504` also carries `Retry-After`.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest/{attestId}/complete`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"completed\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/geo/attest/:attestId/complete",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "geo",
                    "attest",
                    ":attestId",
                    "complete"
                  ],
                  "variable": [
                    {
                      "key": "attestId",
                      "value": "{{attestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Complete buyer network confirmation (JSON)**\n\nNo API key. Same effect as the pixel, with a JSON body. CORS `*`. Every response carries the standard `X-Request-Id` (equal to the body's `requestId`), `X-Avrix-Api-Version` and `X-Api-Version` headers and `Cache-Control: no-store`; a `429`, `503` or `504` also carries `Retry-After`.\n\n**Scopes:** none. This operation reads no API key.\n\n**Rate-limit class:** none. Not counted against an API key's budget.\n\n**Responses:** 200, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `POST /api/seller/v1/geo/attest/{attestId}/complete`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "auth": {
                  "type": "noauth"
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"attestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Requests",
      "description": "Look up a prior API request by id for support and reconciliation.",
      "item": [
        {
          "name": "GET — Inspect a Seller API request by X-Request-Id",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/requests/:requestId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "requests",
                ":requestId"
              ],
              "variable": [
                {
                  "key": "requestId",
                  "value": "{{requestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Inspect a Seller API request by X-Request-Id**\n\nReturns what was recorded about one of your requests, and the webhook deliveries it produced. Raw keys, webhook secrets, PSP tokens and free-form metadata are never returned.\n\n**Two records, two depths.**\n- `callLog`: every response to a request made with one of your keys has a row, never sampled: method, endpoint, status, latency, error code and key. It is looked up for the key owner and the calling key's environment, as `GET /usage` counts. A request refused before the key was identified (`401`) has none.\n- `traces`: the request audit log adds the fields an order or refund needs (`orderReference`, `outcome`, `keyPullId`, ...). It is sampled: on the order, key pull, key export, key return, refund and webhook paths every write and every error the route records is kept; elsewhere `429` and `5xx` responses are kept in full, other `4xx` at about 1 in 10, `2xx` and `3xx` at about 1 in 100. These rates can change.\n\n`coverage` says what was found: `detailed` (a trace), `summary` (a call-log row only) or `none`.\n\n**An id nothing recorded:** on contract date `2026-12-01` and later the answer is `404 NOT_FOUND` with `details.lookupRequestId` and `details.retentionDays`. Earlier dates answer `200` with `coverage: \"none\"` and empty lists.\n\n**Retention:** both records are kept for 90 days.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/requests/{requestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Redacted request trace",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/requests/:requestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "requests",
                    ":requestId"
                  ],
                  "variable": [
                    {
                      "key": "requestId",
                      "value": "{{requestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Inspect a Seller API request by X-Request-Id**\n\nReturns what was recorded about one of your requests, and the webhook deliveries it produced. Raw keys, webhook secrets, PSP tokens and free-form metadata are never returned.\n\n**Two records, two depths.**\n- `callLog`: every response to a request made with one of your keys has a row, never sampled: method, endpoint, status, latency, error code and key. It is looked up for the key owner and the calling key's environment, as `GET /usage` counts. A request refused before the key was identified (`401`) has none.\n- `traces`: the request audit log adds the fields an order or refund needs (`orderReference`, `outcome`, `keyPullId`, ...). It is sampled: on the order, key pull, key export, key return, refund and webhook paths every write and every error the route records is kept; elsewhere `429` and `5xx` responses are kept in full, other `4xx` at about 1 in 10, `2xx` and `3xx` at about 1 in 100. These rates can change.\n\n`coverage` says what was found: `detailed` (a trace), `summary` (a call-log row only) or `none`.\n\n**An id nothing recorded:** on contract date `2026-12-01` and later the answer is `404 NOT_FOUND` with `details.lookupRequestId` and `details.retentionDays`. Earlier dates answer `200` with `coverage: \"none\"` and empty lists.\n\n**Retention:** both records are kept for 90 days.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/requests/{requestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"requestId\": \"df8e4ff5-235a-417a-8ed8-3d3ce0db11cf\",\n    \"traces\": [\n      {\n        \"endpoint\": \"/api/seller/v1/orders\",\n        \"method\": \"POST\",\n        \"statusCode\": 200,\n        \"responseTimeMs\": 1,\n        \"apiKeyId\": \"77c742ad-e20e-4b52-81b3-90a819f3cdcb\",\n        \"integrationContextBytes\": 1,\n        \"pulledCount\": 12,\n        \"allocationId\": \"27985f40-057b-4135-893f-c7183fdc03c0\",\n        \"skuId\": \"43284760-95bd-4db3-83cb-a4943648a850\",\n        \"keyPullId\": \"e7e0666f-07e0-43b6-861c-f254e4d95569\",\n        \"createdAt\": \"2026-11-02T09:30:00Z\",\n        \"orderReference\": \"store-order-10432\",\n        \"outcome\": \"fulfilled\"\n      }\n    ],\n    \"webhookDeliveries\": [\n      {\n        \"deliveryId\": \"0c62d44a-14e5-431d-8d6b-f98a571a695a\",\n        \"eventId\": \"b40aef82-f632-4220-8465-afbd19eedcce\",\n        \"eventType\": \"order.fulfilled\",\n        \"endpointId\": \"f23c96dd-f210-4222-8f37-58887a41a37f\",\n        \"status\": \"succeeded\",\n        \"attempts\": 1,\n        \"responseStatus\": 200,\n        \"orderReference\": \"store-order-10432\",\n        \"sameRequest\": true,\n        \"createdAt\": \"2026-11-02T09:30:00Z\",\n        \"lastAttemptAt\": \"2026-11-02T09:30:00Z\"\n      }\n    ]\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/requests/:requestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "requests",
                    ":requestId"
                  ],
                  "variable": [
                    {
                      "key": "requestId",
                      "value": "{{requestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Inspect a Seller API request by X-Request-Id**\n\nReturns what was recorded about one of your requests, and the webhook deliveries it produced. Raw keys, webhook secrets, PSP tokens and free-form metadata are never returned.\n\n**Two records, two depths.**\n- `callLog`: every response to a request made with one of your keys has a row, never sampled: method, endpoint, status, latency, error code and key. It is looked up for the key owner and the calling key's environment, as `GET /usage` counts. A request refused before the key was identified (`401`) has none.\n- `traces`: the request audit log adds the fields an order or refund needs (`orderReference`, `outcome`, `keyPullId`, ...). It is sampled: on the order, key pull, key export, key return, refund and webhook paths every write and every error the route records is kept; elsewhere `429` and `5xx` responses are kept in full, other `4xx` at about 1 in 10, `2xx` and `3xx` at about 1 in 100. These rates can change.\n\n`coverage` says what was found: `detailed` (a trace), `summary` (a call-log row only) or `none`.\n\n**An id nothing recorded:** on contract date `2026-12-01` and later the answer is `404 NOT_FOUND` with `details.lookupRequestId` and `details.retentionDays`. Earlier dates answer `200` with `coverage: \"none\"` and empty lists.\n\n**Retention:** both records are kept for 90 days.\n\n**Scopes:** `seller:products:read`\n\n**Rate-limit class:** `finance`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/requests/{requestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"requestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Sandbox",
      "description": "Sandbox-only tools: the automatic certification report for your integration.",
      "item": [
        {
          "name": "GET — Get the sandbox certification report",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/sandbox/certification",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "sandbox",
                "certification"
              ]
            },
            "description": "**Get the sandbox certification report**\n\nEvaluates the 28 cases of the Certification guide from the calling sandbox key's own traffic over the last 30 days: requests, webhook deliveries (including test-fire receiver challenges) and sandbox fault scenarios. Each case is `pass`, `fail`, `not_run` or `needs_partner_evidence`, with the request or delivery ids that support it.\n\nCases about behaviour inside your systems (a PSP refund, durable key storage, a delisted product, a rejected signature) stay `needs_partner_evidence` until you submit evidence in the Console and Avrix accepts it. A source that could not be read is reported in `collectionErrors` and never yields `pass`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED`. Any key scope can read the report. The report is computed on each call. It does not enable production access by itself; see the Certification guide for the approval step.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/sandbox/certification`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Certification report",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/certification",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "certification"
                  ]
                },
                "description": "**Get the sandbox certification report**\n\nEvaluates the 28 cases of the Certification guide from the calling sandbox key's own traffic over the last 30 days: requests, webhook deliveries (including test-fire receiver challenges) and sandbox fault scenarios. Each case is `pass`, `fail`, `not_run` or `needs_partner_evidence`, with the request or delivery ids that support it.\n\nCases about behaviour inside your systems (a PSP refund, durable key storage, a delisted product, a rejected signature) stay `needs_partner_evidence` until you submit evidence in the Console and Avrix accepts it. A source that could not be read is reported in `collectionErrors` and never yields `pass`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED`. Any key scope can read the report. The report is computed on each call. It does not enable production access by itself; see the Certification guide for the approval step.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/sandbox/certification`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"reportVersion\": 1,\n    \"generatedAt\": \"2026-10-12T09:30:00.000Z\",\n    \"apiKeyId\": \"5b2f0d1e-7c3a-4e8b-9f61-2a4c8d0e1b37\",\n    \"environment\": {\n      \"mode\": \"isolated\",\n      \"environmentId\": \"0c9e6f4a-1d2b-4c3e-8a7f-5b6d9e0f1a2c\"\n    },\n    \"window\": {\n      \"from\": \"2026-09-12T09:30:00.000Z\",\n      \"to\": \"2026-10-12T09:30:00.000Z\"\n    },\n    \"summary\": {\n      \"pass\": 4,\n      \"fail\": 0,\n      \"not_run\": 20,\n      \"needs_partner_evidence\": 4\n    },\n    \"collectionErrors\": [],\n    \"cases\": [\n      {\n        \"number\": 1,\n        \"name\": \"Cold-start sync\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Take GET /catalog/snapshot, then follow GET /catalog/changes with its cursor.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 2,\n        \"name\": \"Incremental sync\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Poll GET /catalog/changes at least twice with the cursor it returns.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 3,\n        \"name\": \"Tombstone handling\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Follow GET /catalog/changes across a churn window.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 4,\n        \"name\": \"Allocation merge\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Read GET /allocations and merge it into your catalog.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 5,\n        \"name\": \"Unsellable SKU excluded\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"No request touched SANDBOX-NOALLOC-001 yet.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 6,\n        \"name\": \"Non-live product excluded\",\n        \"group\": \"catalog\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"No request touched SANDBOX-LIFECYCLE-001 yet.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 7,\n        \"name\": \"Happy path\",\n        \"group\": \"orders\",\n        \"status\": \"pass\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"An order for SANDBOX-ALWAYS-001 was fulfilled.\",\n        \"observations\": [\n          {\n            \"at\": \"2026-10-12T08:10:04.000Z\",\n            \"requestId\": \"req_7f3a91c2\",\n            \"detail\": \"POST /api/seller/v1/orders → 200 (SANDBOX-ALWAYS-001)\"\n          },\n          {\n            \"at\": \"2026-10-12T08:10:09.000Z\",\n            \"requestId\": \"req_7f3a91c3\",\n            \"detail\": \"POST /api/seller/v1/orders → 200 (SANDBOX-ALWAYS-001)\"\n          }\n        ],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 8,\n        \"name\": \"Preview gating\",\n        \"group\": \"orders\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Call POST /orders/preview before charging.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 9,\n        \"name\": \"Sold out after payment\",\n        \"group\": \"orders\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Order SANDBOX-NOKEYS-001 after a (test) payment.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 10,\n        \"name\": \"Price drift\",\n        \"group\": \"orders\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Order SANDBOX-PRICE-MIS-001 with a wrong expectedUnitPriceCents.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 11,\n        \"name\": \"Territory rejection\",\n        \"group\": \"orders\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Order SANDBOX-TERR-BLOCK-001 for a US buyer.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 12,\n        \"name\": \"Idempotent replay\",\n        \"group\": \"orders\",\n        \"status\": \"pass\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"A retry with the same key and body returned the original order.\",\n        \"observations\": [\n          {\n            \"at\": \"2026-10-12T08:10:09.000Z\",\n            \"requestId\": \"req_7f3a91c3\",\n            \"detail\": \"POST /api/seller/v1/orders → 200 (SANDBOX-ALWAYS-001)\"\n          }\n        ],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 13,\n        \"name\": \"Idempotency conflict\",\n        \"group\": \"orders\",\n        \"status\": \"pass\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Reusing a key with a different body was refused with IDEMPOTENCY_KEY_MISMATCH.\",\n        \"observations\": [\n          {\n            \"at\": \"2026-10-12T08:11:30.000Z\",\n            \"requestId\": \"req_7f3a91c4\",\n            \"detail\": \"POST /api/seller/v1/orders → 409 IDEMPOTENCY_KEY_MISMATCH\"\n          }\n        ],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 14,\n        \"name\": \"Unknown outcome\",\n        \"group\": \"orders\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Run the timeout_then_success or error_after_commit scenario and recover it.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 15,\n        \"name\": \"Key persistence\",\n        \"group\": \"fulfilment\",\n        \"status\": \"needs_partner_evidence\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Show that keys are written to durable storage before you answer the buyer.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 16,\n        \"name\": \"Key non-recovery\",\n        \"group\": \"fulfilment\",\n        \"status\": \"needs_partner_evidence\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Show that your fulfilment never depends on GET /orders returning plaintext keys.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 17,\n        \"name\": \"Valid signature\",\n        \"group\": \"webhooks\",\n        \"status\": \"pass\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"A correctly signed delivery was accepted.\",\n        \"observations\": [\n          {\n            \"at\": \"2026-10-12T08:20:00.000Z\",\n            \"deliveryId\": \"8d4e2b1a-6c3f-4a5e-9b7d-1f2e3c4d5a6b\",\n            \"detail\": \"order.fulfilled → 200\"\n          }\n        ],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 18,\n        \"name\": \"Invalid signature\",\n        \"group\": \"webhooks\",\n        \"status\": \"needs_partner_evidence\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Your endpoint refused the mis-signed delivery. Show that it was refused for the signature, not for another reason.\",\n        \"observations\": [\n          {\n            \"at\": \"2026-10-12T08:21:00.000Z\",\n            \"deliveryId\": \"9e5f3c2b-7d4a-4b6f-8c8e-2a3f4d5e6b7c\",\n            \"detail\": \"order.fulfilled mis-signed delivery → 401\"\n          }\n        ],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 19,\n        \"name\": \"Stale timestamp\",\n        \"group\": \"webhooks\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Fire a test event with challenge \\\"stale_timestamp\\\" (POST /webhooks/{id}/test).\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 20,\n        \"name\": \"Duplicate delivery\",\n        \"group\": \"webhooks\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Fire a test event with challenge \\\"duplicate\\\" and acknowledge both deliveries.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 21,\n        \"name\": \"Webhook before response\",\n        \"group\": \"webhooks\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Run the webhook_delay_duplicate scenario on an order.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 22,\n        \"name\": \"Secret rotation\",\n        \"group\": \"webhooks\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Rotate the secret, then fire a \\\"valid\\\" and a \\\"previous_secret_only\\\" test event during the overlap.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 23,\n        \"name\": \"Key return\",\n        \"group\": \"refunds\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Return keys with POST /refunds using the keyIds from the order response.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 24,\n        \"name\": \"Refund recorded\",\n        \"group\": \"refunds\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"After a refund, read it with GET /refunds.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 25,\n        \"name\": \"Rate limit\",\n        \"group\": \"operations\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Trigger a 429 (X-Avrix-Sandbox-Simulate: rate_limit) and honour Retry-After.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 26,\n        \"name\": \"Server error\",\n        \"group\": \"operations\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Trigger a 5xx (X-Avrix-Sandbox-Simulate: internal_error or a scenario) and retry.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 27,\n        \"name\": \"Request correlation\",\n        \"group\": \"operations\",\n        \"status\": \"needs_partner_evidence\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"Show requestId logged on every error in your logs.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      },\n      {\n        \"number\": 28,\n        \"name\": \"Reconciliation\",\n        \"group\": \"operations\",\n        \"status\": \"not_run\",\n        \"evidenceQuality\": \"complete\",\n        \"reason\": \"List GET /orders at least twice, an hour or more apart.\",\n        \"observations\": [],\n        \"partnerEvidence\": \"none\"\n      }\n    ],\n    \"notCovered\": [\n      {\n        \"area\": \"promotions\",\n        \"reason\": \"Answering event shares and deals, and promotion events. Rehearse them on SANDBOX-PROMO-001 (Sandbox guide, Promotions).\"\n      },\n      {\n        \"area\": \"finance_statements\",\n        \"reason\": \"Invoices, statements and payouts. Sandbox sales are kept out of settlement, so there is nothing to certify against.\"\n      },\n      {\n        \"area\": \"key_management\",\n        \"reason\": \"Creating, rotating and revoking API keys and IP allowlists. Check them against the Authentication guide.\"\n      },\n      {\n        \"area\": \"allocation_requests\",\n        \"reason\": \"Asking a vendor for more stock and handling the decision. Rehearse it with POST /sandbox/allocations/requests/{requestId}/resolve.\"\n      },\n      {\n        \"area\": \"partner_access\",\n        \"reason\": \"Accepting or declining an access proposal. Rehearse it on the proposal the isolated sandbox offers (POST /sandbox/reset offers a new one).\"\n      }\n    ]\n  },\n  \"meta\": {\n    \"requestId\": \"req_av1203_example\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/certification",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "certification"
                  ]
                },
                "description": "**Get the sandbox certification report**\n\nEvaluates the 28 cases of the Certification guide from the calling sandbox key's own traffic over the last 30 days: requests, webhook deliveries (including test-fire receiver challenges) and sandbox fault scenarios. Each case is `pass`, `fail`, `not_run` or `needs_partner_evidence`, with the request or delivery ids that support it.\n\nCases about behaviour inside your systems (a PSP refund, durable key storage, a delisted product, a rejected signature) stay `needs_partner_evidence` until you submit evidence in the Console and Avrix accepts it. A source that could not be read is reported in `collectionErrors` and never yields `pass`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED`. Any key scope can read the report. The report is computed on each call. It does not enable production access by itself; see the Certification guide for the approval step.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/sandbox/certification`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Reset your isolated sandbox environment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/sandbox/reset",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "sandbox",
                "reset"
              ]
            },
            "description": "**Reset your isolated sandbox environment**\n\nPuts your store's isolated sandbox environment back in a known state, so a test suite can start from the same place every run:\n\n- open fault scenarios expire and the stock they held is released;\n- pending allocation requests are cancelled;\n- the selling footprint is restored to the sandbox default;\n- every fixture pool is topped up, and the `SANDBOX-ALLOC-REQUEST-001` allocation is back to 5 unsold units;\n- the rehearsal fixtures are re-armed: the promotion share on `SANDBOX-PROMO-001` is pending again, missing deals are re-created, the zero-day refund window on `SANDBOX-REFUND-EXPIRED-001` is restored and, if none is open, a new access proposal is offered.\n\nOrders, keys already sold, refunds and finance records are kept. The call does not wait for webhooks.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the shared data belongs to every store on it. Send an empty body or none. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/reset`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Environment reset",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/reset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "reset"
                  ]
                },
                "description": "**Reset your isolated sandbox environment**\n\nPuts your store's isolated sandbox environment back in a known state, so a test suite can start from the same place every run:\n\n- open fault scenarios expire and the stock they held is released;\n- pending allocation requests are cancelled;\n- the selling footprint is restored to the sandbox default;\n- every fixture pool is topped up, and the `SANDBOX-ALLOC-REQUEST-001` allocation is back to 5 unsold units;\n- the rehearsal fixtures are re-armed: the promotion share on `SANDBOX-PROMO-001` is pending again, missing deals are re-created, the zero-day refund window on `SANDBOX-REFUND-EXPIRED-001` is restored and, if none is open, a new access proposal is offered.\n\nOrders, keys already sold, refunds and finance records are kept. The call does not wait for webhooks.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the shared data belongs to every store on it. Send an empty body or none. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/reset`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"environment\": {\n      \"mode\": \"isolated\",\n      \"environmentId\": \"0c9e6f4a-1d2b-4c3e-8a7f-5b6d9e0f1a2c\"\n    },\n    \"resetAt\": \"2026-12-02T09:30:00.000Z\",\n    \"scenariosExpired\": 1,\n    \"keysReleased\": 4,\n    \"allocationRequestsCancelled\": [\n      \"3b1f8a52-6c0d-4e7a-9b21-5d4c3e2f1a09\"\n    ],\n    \"keysAdded\": 25,\n    \"footprintRestored\": true,\n    \"rehearsal\": {\n      \"refundWindow\": true,\n      \"promotions\": {\n        \"shareId\": \"8e2c4b6a-1f3d-4a5e-9c7b-2d1e0f9a8b7c\",\n        \"shareRearmed\": true,\n        \"dealsCreated\": []\n      },\n      \"accessProposal\": {\n        \"proposalId\": \"6a4d2c1b-9e8f-4a7b-8c6d-5e4f3a2b1c0d\",\n        \"status\": \"created\"\n      }\n    },\n    \"missingFixtures\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/reset",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "reset"
                  ]
                },
                "description": "**Reset your isolated sandbox environment**\n\nPuts your store's isolated sandbox environment back in a known state, so a test suite can start from the same place every run:\n\n- open fault scenarios expire and the stock they held is released;\n- pending allocation requests are cancelled;\n- the selling footprint is restored to the sandbox default;\n- every fixture pool is topped up, and the `SANDBOX-ALLOC-REQUEST-001` allocation is back to 5 unsold units;\n- the rehearsal fixtures are re-armed: the promotion share on `SANDBOX-PROMO-001` is pending again, missing deals are re-created, the zero-day refund window on `SANDBOX-REFUND-EXPIRED-001` is restored and, if none is open, a new access proposal is offered.\n\nOrders, keys already sold, refunds and finance records are kept. The call does not wait for webhooks.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the shared data belongs to every store on it. Send an empty body or none. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/reset`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Decide your pending allocation request (sandbox)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/requests/:requestId/resolve",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "sandbox",
                "allocations",
                "requests",
                ":requestId",
                "resolve"
              ],
              "variable": [
                {
                  "key": "requestId",
                  "value": "{{requestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Decide your pending allocation request (sandbox)**\n\nThe sandbox vendor approves or declines one of your store's pending allocation requests (`POST /allocations/requests`) through the vendor's own path, so you receive `allocation.request_decided` (and, on approval, `allocation.updated`) without waiting for a person. On approval `grantDelta` defaults to the quantity you asked for.\n\nAn approval follows the same stock rule as in production: the allocation cannot promise more keys than the vendor holds. Rehearse approvals on `SANDBOX-ALLOC-REQUEST-001`, an allocation of 5 over 30 keys in stock (`POST /sandbox/reset` brings it back to 5 unsold); the other fixtures' allocations already promise more keys than they hold, so an approval there answers **409** `CONFLICT` with `details.reason: ALLOCATION_CEILING_EXCEEDS_STOCK`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. An approval needs an isolated environment (on the shared sandbox it answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the allocation would grow for every store on it); a decline works on both. A request that is not your store's answers **404** `NOT_FOUND`; one that is no longer pending answers **409** `CONFLICT` with its current `details.status`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/requests/{requestId}/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"decision\": \"approved\",\n  \"grantDelta\": 50\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Request decided",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/requests/:requestId/resolve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "allocations",
                    "requests",
                    ":requestId",
                    "resolve"
                  ],
                  "variable": [
                    {
                      "key": "requestId",
                      "value": "{{requestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Decide your pending allocation request (sandbox)**\n\nThe sandbox vendor approves or declines one of your store's pending allocation requests (`POST /allocations/requests`) through the vendor's own path, so you receive `allocation.request_decided` (and, on approval, `allocation.updated`) without waiting for a person. On approval `grantDelta` defaults to the quantity you asked for.\n\nAn approval follows the same stock rule as in production: the allocation cannot promise more keys than the vendor holds. Rehearse approvals on `SANDBOX-ALLOC-REQUEST-001`, an allocation of 5 over 30 keys in stock (`POST /sandbox/reset` brings it back to 5 unsold); the other fixtures' allocations already promise more keys than they hold, so an approval there answers **409** `CONFLICT` with `details.reason: ALLOCATION_CEILING_EXCEEDS_STOCK`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. An approval needs an isolated environment (on the shared sandbox it answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the allocation would grow for every store on it); a decline works on both. A request that is not your store's answers **404** `NOT_FOUND`; one that is no longer pending answers **409** `CONFLICT` with its current `details.status`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/requests/{requestId}/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"decision\": \"approved\",\n  \"grantDelta\": 50\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"requestId\": \"3b1f8a52-6c0d-4e7a-9b21-5d4c3e2f1a09\",\n    \"status\": \"resolved\",\n    \"resolution\": \"approved\",\n    \"allocationId\": \"9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a\",\n    \"grantDelta\": 50,\n    \"decidedAt\": \"2026-12-02T09:30:00.000Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/requests/:requestId/resolve",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "allocations",
                    "requests",
                    ":requestId",
                    "resolve"
                  ],
                  "variable": [
                    {
                      "key": "requestId",
                      "value": "{{requestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Decide your pending allocation request (sandbox)**\n\nThe sandbox vendor approves or declines one of your store's pending allocation requests (`POST /allocations/requests`) through the vendor's own path, so you receive `allocation.request_decided` (and, on approval, `allocation.updated`) without waiting for a person. On approval `grantDelta` defaults to the quantity you asked for.\n\nAn approval follows the same stock rule as in production: the allocation cannot promise more keys than the vendor holds. Rehearse approvals on `SANDBOX-ALLOC-REQUEST-001`, an allocation of 5 over 30 keys in stock (`POST /sandbox/reset` brings it back to 5 unsold); the other fixtures' allocations already promise more keys than they hold, so an approval there answers **409** `CONFLICT` with `details.reason: ALLOCATION_CEILING_EXCEEDS_STOCK`.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. An approval needs an isolated environment (on the shared sandbox it answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because the allocation would grow for every store on it); a decline works on both. A request that is not your store's answers **404** `NOT_FOUND`; one that is no longer pending answers **409** `CONFLICT` with its current `details.status`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/requests/{requestId}/resolve`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"decision\": \"approved\",\n  \"grantDelta\": 50\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"requestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Send a stock event for your allocation (sandbox)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/:allocationId/stock-events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "sandbox",
                "allocations",
                ":allocationId",
                "stock-events"
              ],
              "variable": [
                {
                  "key": "allocationId",
                  "value": "{{allocationId}}",
                  "description": "Allocation UUID — from GET /allocations"
                }
              ]
            },
            "description": "**Send a stock event for your allocation (sandbox)**\n\nDelivers `allocation.low_stock` or `allocation.depleted` for one of your allocations to the calling key's webhook endpoints, without consuming stock, so you can rehearse your low-stock handling. The payload carries the allocation's real ids; its counts are simulated and the allocation itself does not change, so `GET /allocations/{id}` keeps showing the real numbers. Works on the shared sandbox and in an isolated environment.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/{allocationId}/stock-events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event\": \"low_stock\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "202 Event queued for delivery",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/:allocationId/stock-events",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "allocations",
                    ":allocationId",
                    "stock-events"
                  ],
                  "variable": [
                    {
                      "key": "allocationId",
                      "value": "{{allocationId}}",
                      "description": "Allocation UUID — from GET /allocations"
                    }
                  ]
                },
                "description": "**Send a stock event for your allocation (sandbox)**\n\nDelivers `allocation.low_stock` or `allocation.depleted` for one of your allocations to the calling key's webhook endpoints, without consuming stock, so you can rehearse your low-stock handling. The payload carries the allocation's real ids; its counts are simulated and the allocation itself does not change, so `GET /allocations/{id}` keeps showing the real numbers. Works on the shared sandbox and in an isolated environment.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/{allocationId}/stock-events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"event\": \"low_stock\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 202,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"allocationId\": \"9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a\",\n    \"eventType\": \"allocation.low_stock\",\n    \"payload\": {\n      \"allocationId\": \"9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a\",\n      \"publisherCompanyId\": \"sbxv-4f2a9c1e7b\",\n      \"skuId\": \"2c4e6a8b-0d1f-4e3a-9b5c-7d9e1f3a5b7c\",\n      \"quantityLimit\": 500,\n      \"quantityPulled\": 450,\n      \"remaining\": 50,\n      \"reason\": \"pulled\"\n    }\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/allocations/:allocationId/stock-events",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "allocations",
                    ":allocationId",
                    "stock-events"
                  ],
                  "variable": [
                    {
                      "key": "allocationId",
                      "value": "{{allocationId}}",
                      "description": "Allocation UUID — from GET /allocations"
                    }
                  ]
                },
                "description": "**Send a stock event for your allocation (sandbox)**\n\nDelivers `allocation.low_stock` or `allocation.depleted` for one of your allocations to the calling key's webhook endpoints, without consuming stock, so you can rehearse your low-stock handling. The payload carries the allocation's real ids; its counts are simulated and the allocation itself does not change, so `GET /allocations/{id}` keeps showing the real numbers. Works on the shared sandbox and in an isolated environment.\n\n**Sandbox keys only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 202, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/allocations/{allocationId}/stock-events`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"event\": \"low_stock\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"allocationId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Start or end a deal now (sandbox)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/sandbox/promotions/deals/:responseId/window",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "sandbox",
                "promotions",
                "deals",
                ":responseId",
                "window"
              ],
              "variable": [
                {
                  "key": "responseId",
                  "value": "{{responseId}}",
                  "description": "Deal response UUID — from GET /promotions/deals"
                }
              ]
            },
            "description": "**Start or end a deal now (sandbox)**\n\nMoves a sandbox vendor's deal so it starts (`action: start`) or ends (`action: end`) now instead of on its dates. For a deal you approved, `promotion.started` or `promotion.ended` is sent to the calling key's endpoints; the regular window job does not send it again. Starting a deal you have not answered closes it for answers, as a real start does, so you can also rehearse the refused late answer.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because every store there holds the same deals. A deal that is not yours answers **404** `NOT_FOUND`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/promotions/deals/{responseId}/window`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"start\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Deal window moved",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/promotions/deals/:responseId/window",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "promotions",
                    "deals",
                    ":responseId",
                    "window"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Start or end a deal now (sandbox)**\n\nMoves a sandbox vendor's deal so it starts (`action: start`) or ends (`action: end`) now instead of on its dates. For a deal you approved, `promotion.started` or `promotion.ended` is sent to the calling key's endpoints; the regular window job does not send it again. Starting a deal you have not answered closes it for answers, as a real start does, so you can also rehearse the refused late answer.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because every store there holds the same deals. A deal that is not yours answers **404** `NOT_FOUND`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/promotions/deals/{responseId}/window`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"action\": \"start\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"responseId\": \"5c3a1e9f-7b6d-4c2a-8e0f-1a2b3c4d5e6f\",\n    \"status\": \"approved\",\n    \"startDate\": \"2026-12-02T09:29:00.000Z\",\n    \"endDate\": \"2026-12-09T09:30:00.000Z\",\n    \"eventType\": \"promotion.started\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/sandbox/promotions/deals/:responseId/window",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "sandbox",
                    "promotions",
                    "deals",
                    ":responseId",
                    "window"
                  ],
                  "variable": [
                    {
                      "key": "responseId",
                      "value": "{{responseId}}",
                      "description": "Deal response UUID — from GET /promotions/deals"
                    }
                  ]
                },
                "description": "**Start or end a deal now (sandbox)**\n\nMoves a sandbox vendor's deal so it starts (`action: start`) or ends (`action: end`) now instead of on its dates. For a deal you approved, `promotion.started` or `promotion.ended` is sent to the calling key's endpoints; the regular window job does not send it again. Starting a deal you have not answered closes it for answers, as a real start does, so you can also rehearse the refused late answer.\n\n**Sandbox keys in an isolated environment only**: a production key answers **422** `SANDBOX_KEY_REQUIRED` and nothing is read or changed; on the shared sandbox the call answers **422** `SANDBOX_ISOLATED_ENVIRONMENT_REQUIRED`, because every store there holds the same deals. A deal that is not yours answers **404** `NOT_FOUND`. `Idempotency-Key` is optional.\n\n**Scopes:** any Seller API scope. No specific scope is checked.\n\n**Rate-limit class:** `general`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/sandbox/promotions/deals/{responseId}/window`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"action\": \"start\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"responseId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Api-keys",
      "description": "",
      "item": [
        {
          "name": "GET — List API keys",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/api-keys?limit=50&cursor=&filters=",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "api-keys"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size (1–100, default 50). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                  "disabled": true
                },
                {
                  "key": "filters",
                  "value": "",
                  "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                  "disabled": true
                }
              ]
            },
            "description": "**List API keys**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `GET /keys`, which is the deprecated name of this operation.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Requires `seller:keys:write` scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Masked keys",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys?limit=50&cursor=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List API keys**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `GET /keys`, which is the deprecated name of this operation.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Requires `seller:keys:write` scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"id\": \"99c6660a-c74f-4897-8b7f-273274235912\",\n      \"name\": \"Example Game\",\n      \"prefix\": \"avrix_sk_sbx_\",\n      \"lastChars\": \"9f2c\",\n      \"createdAt\": \"2026-11-02T09:30:00Z\",\n      \"expiresAt\": \"2026-11-02T09:30:00Z\",\n      \"lastUsedAt\": \"2026-11-02T09:30:00Z\",\n      \"status\": \"active\",\n      \"revokedAt\": \"2026-11-02T09:30:00Z\",\n      \"scopes\": [],\n      \"environment\": \"production\",\n      \"allowedIps\": [\n        \"example_allowedip\"\n      ]\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"count\": 12,\n    \"nextCursor\": \"eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"nextUrl\": \"https://api.avrix.io/api/seller/v1/api-keys?cursor=eyJ2IjoyLCJ0IjoiMjAyNi0xMS0wMlQwOTozMDowMFoifQ\",\n    \"hasMore\": true\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys?limit=50&cursor=&filters=",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size (1–100, default 50). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor` of the previous page.",
                      "disabled": true
                    },
                    {
                      "key": "filters",
                      "value": "",
                      "description": "Optional JSON filter DSL `[{ \"field\", \"op\", \"value\" }]`; fields: `name`. See the filter guide.",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List API keys**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `GET /keys`, which is the deprecated name of this operation.\n\nList API keys for the authenticated company (masked identifiers only; full secrets are never returned). Revoked keys stay listed until archived in the console; each row carries `status` (`active` or `revoked`) and `revokedAt`. Requires `seller:keys:write` scope.\n\n**Paging:** the shared list contract, see `https://docs.avrix.io/seller-api/pagination`. On contract date `2026-12-01` and later a `cursor` this API did not return is refused with `422 VALIDATION_FAILED` (`details.issues[].field` is `cursor`); earlier dates serve the first page.\n\n**Scopes (any one of):** `seller:keys:read`, `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Create an API key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/api-keys",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "api-keys"
              ]
            },
            "description": "**Create an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys`, which is the deprecated name of this operation.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are the server's default set intersected with the calling key's scopes, it inherits the calling key's environment (sandbox keys mint sandbox keys) and expiry, and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"checkout-service\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Key created",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys"
                  ]
                },
                "description": "**Create an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys`, which is the deprecated name of this operation.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are the server's default set intersected with the calling key's scopes, it inherits the calling key's environment (sandbox keys mint sandbox keys) and expiry, and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"checkout-service\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"322466e1-0e24-424a-81fb-e71883103e5e\",\n    \"name\": \"Example Game\",\n    \"key\": \"XXXXX-XXXXX-XXXXX-XXXXX\",\n    \"livemode\": true,\n    \"secretRedacted\": true,\n    \"scopes\": [],\n    \"expiresAt\": \"2026-11-02T09:30:00Z\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys"
                  ]
                },
                "description": "**Create an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys`, which is the deprecated name of this operation.\n\nCreate a new API key. The raw secret is returned **once** in `data.key`; store it securely. **The new key can never exceed the calling key's ceiling**: its scopes are the server's default set intersected with the calling key's scopes, it inherits the calling key's environment (sandbox keys mint sandbox keys) and expiry, and when the calling key is IP-restricted the new key inherits that allowlist (omit `allowed_ips`) or must supply a non-empty subset of it — widening attempts are rejected with `403`. Production child keys additionally require a signed API Revenue Share Channel Terms addendum on the key-owning company (`403 API_MODEL_AGREEMENT_REQUIRED` otherwise). `includeFinanceScope: true` adds `seller:finance:read` only when the calling key holds it (`403 INSUFFICIENT_SCOPE` otherwise). To obtain keys with broader scopes, create them in the console. **`allowed_ips` is optional** (0–50 IPv4/IPv6 literals or CIDR ranges) — when configured, requests from other source IPs are rejected with `403 IP_NOT_ALLOWED`. Strongly recommended; see `https://docs.avrix.io/seller-api/ip-allowlist`. Requires `seller:keys:write` on the **calling** key. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `key` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 201, 400, 401, 403, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"name\": \"checkout-service\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "DELETE — Revoke an API key",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "api-keys",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Revoke an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `DELETE /keys/{id}`, which is the deprecated name of this operation.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/api-keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "204 Key revoked",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Revoke an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `DELETE /keys/{id}`, which is the deprecated name of this operation.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/api-keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "No Content",
              "code": 204,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "DELETE",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Revoke an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `DELETE /keys/{id}`, which is the deprecated name of this operation.\n\nSoft-revoke an API key by UUID. The key immediately stops authenticating but the record is retained for audit (not hard-deleted). This path is for key lifecycle only; `POST /keys/pull` and `POST /keys/export` are separate routes. Requires `seller:keys:write` scope.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `DELETE /api/seller/v1/api-keys/{id}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "PATCH — Replace an API key's IP allowlist",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/allowed-ips",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "api-keys",
                ":id",
                "allowed-ips"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Replace an API key's IP allowlist**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `PATCH /keys/{id}/allowed-ips`, which is the deprecated name of this operation.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/api-keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "204 Allowlist updated. Changes propagate within ~60s as cached entries refresh.",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/allowed-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id",
                    "allowed-ips"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Replace an API key's IP allowlist**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `PATCH /keys/{id}/allowed-ips`, which is the deprecated name of this operation.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/api-keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "No Content",
              "code": 204,
              "_postman_previewlanguage": "text",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": ""
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "PATCH",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/allowed-ips",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id",
                    "allowed-ips"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Replace an API key's IP allowlist**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `PATCH /keys/{id}/allowed-ips`, which is the deprecated name of this operation.\n\nReplace the IP allowlist on an existing key **without rotating the secret**. Use this when your servers move egress IPs (cloud region migration, NAT gateway IP rotation). The PATCH is a full replacement: the new array completely overwrites the old one. Requires `seller:keys:write` scope. See `https://docs.avrix.io/seller-api/ip-allowlist`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 204, 400, 401, 403, 404, 413, 422, 429, 500, 503, 504\n\n**Path:** `PATCH /api/seller/v1/api-keys/{id}/allowed-ips`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"allowed_ips\": [\n    \"203.0.113.10\"\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Rotate an API key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/rotate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "api-keys",
                ":id",
                "rotate"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "{{keyId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Rotate an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys/{id}/rotate`, which is the deprecated name of this operation.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"overlapSeconds\": 3600\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Key rotated",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/rotate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id",
                    "rotate"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Rotate an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys/{id}/rotate`, which is the deprecated name of this operation.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"overlapSeconds\": 3600\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"id\": \"1e56bfac-9e93-45dc-8404-5d5021aedfc4\",\n    \"secret\": \"whsec_8f2c1d0e9b7a6c5d4e3f2a1b0c9d8e7f\",\n    \"previousSecretExpiresAt\": \"2026-11-02T09:30:00Z\",\n    \"secretRedacted\": true\n  },\n  \"meta\": {\n    \"requestId\": \"00b01245-0334-4937-8412-67d0593c24c2\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Optional on this operation. When sent, it follows the same format and replay rules as the required header: 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_`; the same key and body replay the completed response for 24 hours with `Idempotency-Replayed: true`; the same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/api-keys/:id/rotate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "api-keys",
                    ":id",
                    "rotate"
                  ],
                  "variable": [
                    {
                      "key": "id",
                      "value": "{{keyId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Rotate an API key**\n\nAPI credentials live under `/api-keys`; `/keys` names game keys (`/keys/pull`, `/keys/return`, `/keys/export`, `/keys/pulls`). The same handler as `POST /keys/{id}/rotate`, which is the deprecated name of this operation.\n\nIn-place rotation of an API key secret. Returns the new raw secret once, as `data.secret`. Requires `seller:keys:write`. Without a body the replaced secret stops working at once. With `overlapSeconds` it keeps working until `previousSecretExpiresAt`; rotating again before then issues another new secret and keeps that same replaced secret and expiry, and a rotation without `overlapSeconds` ends the window. Revoking the key stops every secret it has. **Retries:** send an `Idempotency-Key` to make a retry safe: the same key and body replay the first answer with `Idempotency-Replayed: true` instead of acting twice. The secret is never stored for a replay: a replayed answer omits `secret` and sets `secretRedacted: true`.\n\n**Scopes:** `seller:keys:write`\n\n**Rate-limit class:** `orders` (`general` from contract date 2026-12-01)\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/api-keys/{id}/rotate`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"overlapSeconds\": 3600\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"keyId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    },
    {
      "name": "Returns",
      "description": "",
      "item": [
        {
          "name": "GET — List return requests",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns?limit=50&cursor=&status=pending",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "Page size: how many items to return (1 to 100). (1–100)",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "pending",
                  "description": "Only requests in this status. enum: pending, info_requested, approved, rejected, cancelled, resolved",
                  "disabled": true
                }
              ]
            },
            "description": "**List return requests**\n\nYour return requests to Content Owners, newest first. Filter by `status`. In the shared sandbox only requests on keys your API key pulled are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Return requests",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns?limit=50&cursor=&status=pending",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Only requests in this status. enum: pending, info_requested, approved, rejected, cancelled, resolved",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List return requests**\n\nYour return requests to Content Owners, newest first. Filter by `status`. In the shared sandbox only requests on keys your API key pulled are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": [\n    {\n      \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n      \"status\": \"pending\",\n      \"reasonCode\": \"key_invalid\",\n      \"details\": \"The buyer reports the key is rejected on activation.\",\n      \"requestedResolution\": \"replacement\",\n      \"resolution\": null,\n      \"publisherCompanyId\": \"co_7f3a9c\",\n      \"currencyCode\": \"EUR\",\n      \"keyCount\": 1,\n      \"decisionNote\": null,\n      \"decidedAt\": null,\n      \"respondBy\": \"2026-12-09T10:00:00Z\",\n      \"reversalStatus\": \"not_required\",\n      \"createdAt\": \"2026-12-02T10:00:00Z\",\n      \"updatedAt\": \"2026-12-02T10:00:00Z\"\n    }\n  ],\n  \"meta\": {\n    \"limit\": 50,\n    \"hasMore\": false,\n    \"nextCursor\": null,\n    \"nextUrl\": null\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns?limit=50&cursor=&status=pending",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns"
                  ],
                  "query": [
                    {
                      "key": "limit",
                      "value": "50",
                      "description": "Page size: how many items to return (1 to 100). (1–100)",
                      "disabled": true
                    },
                    {
                      "key": "cursor",
                      "value": "",
                      "description": "Opaque cursor from `meta.nextCursor`. Send it back unchanged; omit it on the first call.",
                      "disabled": true
                    },
                    {
                      "key": "status",
                      "value": "pending",
                      "description": "Only requests in this status. enum: pending, info_requested, approved, rejected, cancelled, resolved",
                      "disabled": true
                    }
                  ]
                },
                "description": "**List return requests**\n\nYour return requests to Content Owners, newest first. Filter by `status`. In the shared sandbox only requests on keys your API key pulled are listed. Pages with `limit` and `cursor` (the shared list contract). Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — File a return request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns"
              ]
            },
            "description": "**File a return request**\n\nAsk the Content Owner to refund or replace delivered keys (for example a key that does not activate). The Content Owner decides: you get `return.information_requested` when they ask a question and `return.decided` when they approve or reject. The Content Owner is taken from the keys; file one request per Content Owner. Attach files with `POST /returns/{returnRequestId}/evidence`. A refund you already gave your buyer is declared on `POST /refunds` instead. Requires an `Idempotency-Key` and `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`).\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keyIds\": [\n    \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\"\n  ],\n  \"reasonCode\": \"key_invalid\",\n  \"requestedResolution\": \"replacement\",\n  \"details\": \"The buyer reports the key is rejected on activation.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "201 Filed",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns"
                  ]
                },
                "description": "**File a return request**\n\nAsk the Content Owner to refund or replace delivered keys (for example a key that does not activate). The Content Owner decides: you get `return.information_requested` when they ask a question and `return.decided` when they approve or reject. The Content Owner is taken from the keys; file one request per Content Owner. Attach files with `POST /returns/{returnRequestId}/evidence`. A refund you already gave your buyer is declared on `POST /refunds` instead. Requires an `Idempotency-Key` and `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`).\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\"\n  ],\n  \"reasonCode\": \"key_invalid\",\n  \"requestedResolution\": \"replacement\",\n  \"details\": \"The buyer reports the key is rejected on activation.\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n    \"status\": \"pending\",\n    \"reasonCode\": \"key_invalid\",\n    \"details\": \"The buyer reports the key is rejected on activation.\",\n    \"requestedResolution\": \"replacement\",\n    \"resolution\": null,\n    \"publisherCompanyId\": \"co_7f3a9c\",\n    \"currencyCode\": \"EUR\",\n    \"keyCount\": 1,\n    \"decisionNote\": null,\n    \"decidedAt\": null,\n    \"respondBy\": \"2026-12-09T10:00:00Z\",\n    \"reversalStatus\": \"not_required\",\n    \"createdAt\": \"2026-12-02T10:00:00Z\",\n    \"updatedAt\": \"2026-12-02T10:00:00Z\",\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"open\": true,\n        \"replacementKeyId\": null,\n        \"unitPriceCents\": 4999,\n        \"unitPriceMinor\": 4999\n      }\n    ],\n    \"messages\": [],\n    \"evidence\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns"
                  ]
                },
                "description": "**File a return request**\n\nAsk the Content Owner to refund or replace delivered keys (for example a key that does not activate). The Content Owner decides: you get `return.information_requested` when they ask a question and `return.decided` when they approve or reject. The Content Owner is taken from the keys; file one request per Content Owner. Attach files with `POST /returns/{returnRequestId}/evidence`. A refund you already gave your buyer is declared on `POST /refunds` instead. Requires an `Idempotency-Key` and `seller:refunds:write` or `seller:orders:write` (or the legacy `seller:keys:pull`).\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"keyIds\": [\n    \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\"\n  ],\n  \"reasonCode\": \"key_invalid\",\n  \"requestedResolution\": \"replacement\",\n  \"details\": \"The buyer reports the key is rejected on activation.\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "GET — Get a return request",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns",
                ":returnRequestId"
              ],
              "variable": [
                {
                  "key": "returnRequestId",
                  "value": "{{returnRequestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Get a return request**\n\nOne return request with its keys, the message thread with the Content Owner and the evidence attached. 404 when it is not yours. Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns/{returnRequestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 The return request",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a return request**\n\nOne return request with its keys, the message thread with the Content Owner and the evidence attached. 404 when it is not yours. Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns/{returnRequestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n    \"status\": \"pending\",\n    \"reasonCode\": \"key_invalid\",\n    \"details\": \"The buyer reports the key is rejected on activation.\",\n    \"requestedResolution\": \"replacement\",\n    \"resolution\": null,\n    \"publisherCompanyId\": \"co_7f3a9c\",\n    \"currencyCode\": \"EUR\",\n    \"keyCount\": 1,\n    \"decisionNote\": null,\n    \"decidedAt\": null,\n    \"respondBy\": \"2026-12-09T10:00:00Z\",\n    \"reversalStatus\": \"not_required\",\n    \"createdAt\": \"2026-12-02T10:00:00Z\",\n    \"updatedAt\": \"2026-12-02T10:00:00Z\",\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"open\": true,\n        \"replacementKeyId\": null,\n        \"unitPriceCents\": 4999,\n        \"unitPriceMinor\": 4999\n      }\n    ],\n    \"messages\": [],\n    \"evidence\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. `rate_limit` makes this call answer 429 `RATE_LIMIT_EXCEEDED` with `Retry-After: 2` before any work is done, so you can rehearse your back-off. This operation honours no other value. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Get a return request**\n\nOne return request with its keys, the message thread with the Content Owner and the evidence attached. 404 when it is not yours. Scopes: any refund read scope.\n\n**Scopes (any one of):** `seller:refunds:read`, `seller:refunds:write`, `seller:finance:read`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 422, 429, 500, 503, 504\n\n**Path:** `GET /api/seller/v1/returns/{returnRequestId}`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"returnRequestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ]
        },
        {
          "name": "POST — Answer the Content Owner",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/reply",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns",
                ":returnRequestId",
                "reply"
              ],
              "variable": [
                {
                  "key": "returnRequestId",
                  "value": "{{returnRequestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Answer the Content Owner**\n\nAnswer the Content Owner's question on a return request in `info_requested`; it goes back to `pending` and the Content Owner's response time starts again. `message` is optional; attach files with `POST /returns/{returnRequestId}/evidence` before replying. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/reply`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Screenshot of the activation error attached.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "200 Replied",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/reply",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "reply"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Answer the Content Owner**\n\nAnswer the Content Owner's question on a return request in `info_requested`; it goes back to `pending` and the Content Owner's response time starts again. `message` is optional; attach files with `POST /returns/{returnRequestId}/evidence` before replying. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/reply`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"message\": \"Screenshot of the activation error attached.\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n    \"status\": \"pending\",\n    \"reasonCode\": \"key_invalid\",\n    \"details\": \"The buyer reports the key is rejected on activation.\",\n    \"requestedResolution\": \"replacement\",\n    \"resolution\": null,\n    \"publisherCompanyId\": \"co_7f3a9c\",\n    \"currencyCode\": \"EUR\",\n    \"keyCount\": 1,\n    \"decisionNote\": null,\n    \"decidedAt\": null,\n    \"respondBy\": \"2026-12-09T10:00:00Z\",\n    \"reversalStatus\": \"not_required\",\n    \"createdAt\": \"2026-12-02T10:00:00Z\",\n    \"updatedAt\": \"2026-12-02T10:00:00Z\",\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"open\": true,\n        \"replacementKeyId\": null,\n        \"unitPriceCents\": 4999,\n        \"unitPriceMinor\": 4999\n      }\n    ],\n    \"messages\": [\n      {\n        \"messageId\": \"9c8b7a6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\",\n        \"from\": \"content_owner\",\n        \"body\": \"Please send a screenshot of the activation error.\",\n        \"createdAt\": \"2026-12-03T09:00:00Z\"\n      },\n      {\n        \"messageId\": \"1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d\",\n        \"from\": \"seller\",\n        \"body\": \"Screenshot of the activation error attached.\",\n        \"createdAt\": \"2026-12-03T11:00:00Z\"\n      }\n    ],\n    \"evidence\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json",
                    "type": "text"
                  },
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/reply",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "reply"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Answer the Content Owner**\n\nAnswer the Content Owner's question on a return request in `info_requested`; it goes back to `pending` and the Content Owner's response time starts again. `message` is optional; attach files with `POST /returns/{returnRequestId}/evidence` before replying. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/reply`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"message\": \"Screenshot of the activation error attached.\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"returnRequestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Cancel a return request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns",
                ":returnRequestId",
                "cancel"
              ],
              "variable": [
                {
                  "key": "returnRequestId",
                  "value": "{{returnRequestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Cancel a return request**\n\nWithdraw a return request while it is `pending` or `info_requested`. No body. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "200 Cancelled",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Cancel a return request**\n\nWithdraw a return request while it is `pending` or `info_requested`. No body. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\",\n    \"status\": \"cancelled\",\n    \"reasonCode\": \"key_invalid\",\n    \"details\": \"The buyer reports the key is rejected on activation.\",\n    \"requestedResolution\": \"replacement\",\n    \"resolution\": null,\n    \"publisherCompanyId\": \"co_7f3a9c\",\n    \"currencyCode\": \"EUR\",\n    \"keyCount\": 1,\n    \"decisionNote\": null,\n    \"decidedAt\": null,\n    \"respondBy\": null,\n    \"reversalStatus\": \"not_required\",\n    \"createdAt\": \"2026-12-02T10:00:00Z\",\n    \"updatedAt\": \"2026-12-02T10:00:00Z\",\n    \"keys\": [\n      {\n        \"keyId\": \"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f\",\n        \"open\": true,\n        \"replacementKeyId\": null,\n        \"unitPriceCents\": 4999,\n        \"unitPriceMinor\": 4999\n      }\n    ],\n    \"messages\": [],\n    \"evidence\": []\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/cancel",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "cancel"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Cancel a return request**\n\nWithdraw a return request while it is `pending` or `info_requested`. No body. Requires an `Idempotency-Key`.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 200, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/cancel`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"returnRequestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        },
        {
          "name": "POST — Attach evidence to a return request",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                "disabled": false
              },
              {
                "key": "X-Avrix-Api-Version",
                "value": "",
                "type": "text",
                "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                "disabled": true
              },
              {
                "key": "X-Request-Id",
                "value": "{{$guid}}",
                "type": "text",
                "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                "disabled": false
              },
              {
                "key": "X-Avrix-Sandbox-Simulate",
                "value": "",
                "type": "text",
                "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/evidence",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "seller",
                "v1",
                "returns",
                ":returnRequestId",
                "evidence"
              ],
              "variable": [
                {
                  "key": "returnRequestId",
                  "value": "{{returnRequestId}}",
                  "description": "UUID path parameter"
                }
              ]
            },
            "description": "**Attach evidence to a return request**\n\nAttach one file (an image or a PDF, at most 10 MB) to a return request while it is `pending` or `info_requested`. Send `multipart/form-data` with the file in the `file` field. The Content Owner sees it with the request; `GET /returns/{returnRequestId}` lists it. The upload is recorded against the user who created the API key. Requires an `Idempotency-Key`: a retry with the same key and the same file answers with the first upload.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/evidence`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
          },
          "response": [
            {
              "name": "201 Attached",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/evidence",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "evidence"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Attach evidence to a return request**\n\nAttach one file (an image or a PDF, at most 10 MB) to a return request while it is `pending` or `info_requested`. Send `multipart/form-data` with the file in the `file` field. The Content Owner sees it with the request; `GET /returns/{returnRequestId}` lists it. The upload is recorded against the user who created the API key. Requires an `Idempotency-Key`: a retry with the same key and the same file answers with the first upload.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/evidence`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "OK",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "{{$guid}}"
                }
              ],
              "cookie": [],
              "body": "{\n  \"data\": {\n    \"evidenceId\": \"5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a\",\n    \"returnRequestId\": \"0b6e4f1a-2c3d-4e5f-8a9b-1c2d3e4f5a6b\"\n  }\n}"
            },
            {
              "name": "401 Missing or invalid bearer token",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Idempotency-Key",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Client-generated key that makes this write safe to retry. **Format:** 1 to 64 characters from `A-Z`, `a-z`, `0-9`, `-` and `_` (a UUID fits). Send the same key and the same JSON body when you retry: a completed request is replayed for 24 hours with `Idempotency-Replayed: true`, and failed (4xx/5xx) responses are never stored, so a retry after fixing the cause runs again. The same key with a different body returns 409 `IDEMPOTENCY_KEY_MISMATCH`. A missing or malformed key returns 400 `IDEMPOTENCY_KEY_REQUIRED` on contract date `2026-12-01` and later (`BAD_REQUEST` on earlier dates).",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Api-Version",
                    "value": "",
                    "type": "text",
                    "description": "Pins the contract date this request is served on, so a later default never changes what your integration sees. Omit it to be served on the stamped default (see the contract dates in the introduction). `next` resolves to the newest date, opt-in dates included: use it to try what is coming, not in production code. A value that is not in the list is refused with 400 `UNSUPPORTED_API_VERSION` and `details.supportedVersions`. The response header of the same name tells you which date served the request. See `https://docs.avrix.io/seller-api/versioning`.",
                    "disabled": true
                  },
                  {
                    "key": "X-Request-Id",
                    "value": "{{$guid}}",
                    "type": "text",
                    "description": "Your own correlation id for this attempt: 8 to 128 characters from `A-Z`, `a-z`, `0-9`, `_`, `.`, `:` and `-` (a UUID or ULID fits). It comes back in the `X-Request-Id` response header and as `requestId` in error bodies, and `GET /requests/{requestId}` finds the request by it. Omit it and a UUID is generated. Send a new value for every attempt, retries included. On contract date `2026-12-01` and later a value outside that format is refused with `400 INVALID_REQUEST_ID` before anything runs; earlier dates echo any value as sent.",
                    "disabled": false
                  },
                  {
                    "key": "X-Avrix-Sandbox-Simulate",
                    "value": "",
                    "type": "text",
                    "description": "Sandbox keys only; a production key's header is ignored on every contract date. Makes this call fail on purpose, before any work is done, so you can rehearse your retry logic: `rate_limit` (429 `RATE_LIMIT_EXCEEDED`, `Retry-After: 2`), `internal_error` (500 `INTERNAL_ERROR`), `service_unavailable` (503 `SERVICE_UNAVAILABLE`, `Retry-After: 5`). Retry with the same `Idempotency-Key` where the operation takes one. On contract date `2026-12-01` or later (`X-Avrix-Api-Version: 2026-12-01` or `next`), a sandbox call with any other value, a misspelling included, answers 422 `SANDBOX_SIMULATE_UNKNOWN` before any work, and `details.honoured` lists the values this operation accepts. On earlier dates such a value is ignored and the call runs normally; so are `internal_error` and `service_unavailable`, and on `POST /orders/cancel`, `POST /orders/recover-keys`, `POST /keys/export`, `POST /keys/return`, `POST /refunds` and `POST /chargebacks/resolve` every value, as before.",
                    "disabled": true
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/seller/v1/returns/:returnRequestId/evidence",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "seller",
                    "v1",
                    "returns",
                    ":returnRequestId",
                    "evidence"
                  ],
                  "variable": [
                    {
                      "key": "returnRequestId",
                      "value": "{{returnRequestId}}",
                      "description": "UUID path parameter"
                    }
                  ]
                },
                "description": "**Attach evidence to a return request**\n\nAttach one file (an image or a PDF, at most 10 MB) to a return request while it is `pending` or `info_requested`. Send `multipart/form-data` with the file in the `file` field. The Content Owner sees it with the request; `GET /returns/{returnRequestId}` lists it. The upload is recorded against the user who created the API key. Requires an `Idempotency-Key`: a retry with the same key and the same file answers with the first upload.\n\n**Scopes (any one of):** `seller:refunds:write`, `seller:orders:write`, `seller:keys:pull`\n\n**Rate-limit class:** `orders`\n\n**Responses:** 201, 400, 401, 403, 404, 409, 413, 422, 429, 500, 503, 504\n**Idempotency:** send a UUID in `Idempotency-Key`. Retries with the same key + canonical JSON body return the cached successful response within 24h; failed responses are never cached, so retry the same key after fixing the cause. Body mismatch → **409** `IDEMPOTENCY_KEY_MISMATCH`.\n\n**Path:** `POST /api/seller/v1/returns/{returnRequestId}/evidence`\n**Docs:** [Error playbook](https://docs.avrix.io/seller-api/errors) • [Scope matrix](https://docs.avrix.io/seller-api/scopes) • [Integration recipes](https://docs.avrix.io/seller-api/integration-recipes) • [Sandbox](https://docs.avrix.io/seller-api/sandbox)"
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-Api-Version",
                  "value": "1"
                },
                {
                  "key": "X-Request-Id",
                  "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
                }
              ],
              "cookie": [],
              "body": "{\n  \"code\": \"UNAUTHORIZED\",\n  \"message\": \"Missing or invalid Authorization header\",\n  \"error\": \"Missing or invalid Authorization header\",\n  \"timestamp\": \"2026-04-23T12:00:00.000Z\",\n  \"recoverable\": true,\n  \"hint\": \"Check your API key in Settings → API Keys\",\n  \"doc_url\": \"https://docs.avrix.io/seller-api/errors#unauthorized\",\n  \"requestId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"\n}"
            }
          ],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Skip when path parameters are unset — safe default for disabled mutating ops",
                  "const required = [\"returnRequestId\"];",
                  "for (const k of required) {",
                  "  const v = pm.environment.get(k) || pm.collectionVariables.get(k);",
                  "  if (!v || String(v).trim() === '') {",
                  "    console.log('[' + pm.info.requestName + '] skipped: set the ' + k + ' variable first (it comes from an earlier response)');",
                  "    if (pm.execution && typeof pm.execution.skipRequest === 'function') {",
                  "      pm.execution.skipRequest();",
                  "    }",
                  "    return;",
                  "  }",
                  "}"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const rid = pm.response.headers.get('X-Request-Id');",
                  "if (rid) { console.log('X-Request-Id:', rid); }",
                  "const rep = pm.response.headers.get('Idempotency-Replayed');",
                  "if (rep) { console.log('Idempotency-Replayed:', rep); }",
                  "const xc = pm.response.headers.get('X-Cache');",
                  "if (xc) { console.log('X-Cache:', xc); }",
                  "const rl = pm.response.headers.get('X-RateLimit-Remaining');",
                  "if (rl) { console.log('X-RateLimit-Remaining:', rl); }",
                  "if (pm.response.code === 0) { return; }",
                  "const urlStr = pm.request.url.toString();",
                  "const placeholders = urlStr.match(/\\{\\{[^}]+\\}\\}/g) || [];",
                  "for (const ph of placeholders) {",
                  "  const key = ph.slice(2, -2);",
                  "  const val = pm.environment.get(key) || pm.collectionVariables.get(key);",
                  "  if (!val) { return; }",
                  "}",
                  "if (pm.response.code >= 200 && pm.response.code < 300) {",
                  "  pm.test('2xx success', () => pm.expect(pm.response.code).to.be.within(200, 299));",
                  "} else if (pm.response.code === 429) {",
                  "  const ra = pm.response.headers.get('Retry-After');",
                  "  if (ra) { console.log('Retry-After:', ra, 'seconds'); }",
                  "}",
                  "if (pm.response.code >= 400) {",
                  "  pm.test('error envelope is well-formed', () => {",
                  "    const ct = (pm.response.headers.get('Content-Type') || '').toLowerCase();",
                  "    if (!ct.includes('application/json')) {",
                  "      if (pm.response.code === 405 || pm.response.code === 404) { return; }",
                  "      pm.expect.fail('Expected JSON error body, got Content-Type: ' + ct);",
                  "      return;",
                  "    }",
                  "    const text = pm.response.text();",
                  "    pm.expect(text && text.trim().length > 0, 'Empty error body').to.be.true;",
                  "    const json = JSON.parse(text);",
                  "    pm.expect(json).to.have.property('code');",
                  "    pm.expect(json).to.have.property('message');",
                  "  });",
                  "}"
                ]
              }
            }
          ],
          "disabled": true
        }
      ]
    }
  ]
}
