{ "item": [ { "id": "591935b15b1c88e2d5f6be0a054604fc", "name": "Public", "description": { "content": "Unauthenticated endpoints (health checks, spec retrieval).", "type": "text/plain" }, "item": [ { "id": "a070a26d79f93e7106b207ebfd83b50e", "name": "Health check", "request": { "name": "Health check", "description": { "content": "Liveness probe for monitoring. Returns the current API version and a static `ok` status. No authentication required.", "type": "text/plain" }, "url": { "path": [ "v1", "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "266758a145e4889e79ffeab4b1bd583c", "name": "API is reachable.", "originalRequest": { "url": { "path": [ "v1", "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"api_version\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8c967c550ad5cde227af40eeac1bc940", "name": "OpenAPI specification", "request": { "name": "OpenAPI specification", "description": { "content": "Returns this document. Useful for client generators that want to fetch the spec at runtime. No authentication required.", "type": "text/plain" }, "url": { "path": [ "v1", "openapi.json" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "a2b754e22811b56bc935f93b3275f57f", "name": "OpenAPI 3.1 document describing the v1 API.", "originalRequest": { "url": { "path": [ "v1", "openapi.json" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "9a42d40a3f319da59ce05d08f77f348f", "name": "Integration", "description": { "content": "Integration health and configuration introspection.", "type": "text/plain" }, "item": [ { "id": "2b8e8118f16e267d996118b7b28c8b3b", "name": "Integration health", "request": { "name": "Integration health", "description": { "content": "Returns the calling dealer's integration row including webhook delivery state and subscribed events. Use this to verify credentials and surface webhook health in your UI.", "type": "text/plain" }, "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "c3c15c39b60d4b57a6f580e02c2b74b7", "name": "Integration row for the caller.", "originalRequest": { "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"api_version\": \"string\",\n \"is_enabled\": false,\n \"is_test_mode\": false,\n \"object\": \"string\",\n \"subscribed_events\": [\n \"string\",\n \"string\"\n ],\n \"user_id\": \"string\",\n \"webhook\": {\n \"consecutive_failures\": 0,\n \"last_failure_at\": \"string\",\n \"last_success_at\": \"string\",\n \"url\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "14068ccf943eeea5eb5c20a33a69b17b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df972e2f9d57d014ef8f54c9e82a6fdc", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "me" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "5009238dba6b31d610e5dbaf893e2823", "name": "Listings", "description": { "content": "Inventory items the dealer has published to the custom integration.", "type": "text/plain" }, "item": [ { "id": "1cd7c91f699a4a7ba73d19c88d5f0736", "name": "List active listings", "request": { "name": "List active listings", "description": { "content": "Cursor-paginated list of items the dealer has published to the custom integration.", "type": "text/plain" }, "url": { "path": [ "v1", "listings" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "" }, { "disabled": false, "key": "after", "value": "" }, { "disabled": false, "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "eccf3f43b4117fa9e876278880d8c8a2", "name": "Paginated list of listings.", "originalRequest": { "url": { "path": [ "v1", "listings" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"created_at\": \"string\",\n \"description\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"object\": \"string\",\n \"photos\": [\n {\n \"order\": 0,\n \"url\": \"string\"\n },\n {\n \"order\": 0,\n \"url\": \"string\"\n }\n ],\n \"price\": {\n \"amount\": 0,\n \"amount_formatted\": \"string\",\n \"currency\": \"string\"\n },\n \"status\": \"string\",\n \"updated_at\": \"string\",\n \"watch\": {\n \"brand\": \"string\",\n \"case_material\": \"string\",\n \"case_size_mm\": 0,\n \"complications\": [\n \"string\",\n \"string\"\n ],\n \"condition\": \"string\",\n \"dial_color\": \"string\",\n \"model\": \"string\",\n \"movement_type\": \"string\",\n \"reference\": \"string\",\n \"watch_set\": \"string\",\n \"year\": 0\n }\n },\n {\n \"created_at\": \"string\",\n \"description\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"object\": \"string\",\n \"photos\": [\n {\n \"order\": 0,\n \"url\": \"string\"\n },\n {\n \"order\": 0,\n \"url\": \"string\"\n }\n ],\n \"price\": {\n \"amount\": 0,\n \"amount_formatted\": \"string\",\n \"currency\": \"string\"\n },\n \"status\": \"string\",\n \"updated_at\": \"string\",\n \"watch\": {\n \"brand\": \"string\",\n \"case_material\": \"string\",\n \"case_size_mm\": 0,\n \"complications\": [\n \"string\",\n \"string\"\n ],\n \"condition\": \"string\",\n \"dial_color\": \"string\",\n \"model\": \"string\",\n \"movement_type\": \"string\",\n \"reference\": \"string\",\n \"watch_set\": \"string\",\n \"year\": 0\n }\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"string\",\n \"object\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b88b93f1f50188d9a3065891f28f572", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "listings" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "137dc99f1c0579767db3534d30b44eea", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "listings" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "52cda94fe6033437a546fc5afa7dd11e", "name": "Retrieve a listing", "request": { "name": "Retrieve a listing", "description": { "content": "Fetch a single listing by its WTH `lst_*` identifier.", "type": "text/plain" }, "url": { "path": [ "v1", "listings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "28d60e5d4ba78a8a3f15c8ecf416f863", "name": "A listing.", "originalRequest": { "url": { "path": [ "v1", "listings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"created_at\": \"string\",\n \"description\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"object\": \"string\",\n \"photos\": [\n {\n \"order\": 0,\n \"url\": \"string\"\n },\n {\n \"order\": 0,\n \"url\": \"string\"\n }\n ],\n \"price\": {\n \"amount\": 0,\n \"amount_formatted\": \"string\",\n \"currency\": \"string\"\n },\n \"status\": \"string\",\n \"updated_at\": \"string\",\n \"watch\": {\n \"brand\": \"string\",\n \"case_material\": \"string\",\n \"case_size_mm\": 0,\n \"complications\": [\n \"string\",\n \"string\"\n ],\n \"condition\": \"string\",\n \"dial_color\": \"string\",\n \"model\": \"string\",\n \"movement_type\": \"string\",\n \"reference\": \"string\",\n \"watch_set\": \"string\",\n \"year\": 0\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7f8a085988b7c3bb2ea1f92634c206fd", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "listings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "27f3eae52f6b19ca918ceb5b360e93f9", "name": "Listing not found.", "originalRequest": { "url": { "path": [ "v1", "listings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dfea8752e66df122230fd564652b8171", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "listings", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "b7e8acdd522e6190ac9567ad16dff987", "name": "Orders", "description": { "content": "Orders flowing in from the dealer's site (and cancellation).", "type": "text/plain" }, "item": [ { "id": "f249777d744dc779307f816df5cbae8f", "name": "Create an order", "request": { "name": "Create an order", "description": { "content": "Reports an order placed on the dealer's site. Wired into the existing channel-order matching pipeline. Requires an `Idempotency-Key` header — replays return the original response.", "type": "text/plain" }, "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "84e2c5347d35e902fabad82032d4268e", "name": "Order created and queued for matching.", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"buyer\": {\n \"address_line1\": \"string\",\n \"address_line2\": \"string\",\n \"city\": \"string\",\n \"country\": \"string\",\n \"email\": \"string\",\n \"name\": \"string\",\n \"phone\": \"string\",\n \"postal_code\": \"string\",\n \"region\": \"string\"\n },\n \"channel_order_id\": \"string\",\n \"created_at\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n },\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n }\n ],\n \"object\": \"string\",\n \"ordered_at\": \"string\",\n \"status\": \"string\",\n \"total_amount\": 0\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fdd5a0fb97f1d9c7e8806e7c8d688a9c", "name": "Validation error.", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90cd4e807f6256666e065f0e9447208d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "59038a5b01cd5154f72d5fc03667830b", "name": "Duplicate channel_order_id or idempotency-key body mismatch.", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a09d3bc6d6fe1f1dabba14d98d91ba67", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"buyer\": {},\n \"channel_order_id\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": \"string\"\n }\n ],\n \"metadata\": {\n \"key_0\": {}\n },\n \"ordered_at\": \"string\",\n \"total_amount\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "132cf460cb859e4cbcce311262568da6", "name": "List orders", "request": { "name": "List orders", "description": { "content": "Cursor-paginated list of orders reported through the custom integration.", "type": "text/plain" }, "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "limit", "value": "" }, { "disabled": false, "key": "after", "value": "" }, { "disabled": false, "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "acd506c177a0509c9ae830f96c5e379c", "name": "Paginated list of orders.", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"buyer\": {\n \"address_line1\": \"string\",\n \"address_line2\": \"string\",\n \"city\": \"string\",\n \"country\": \"string\",\n \"email\": \"string\",\n \"name\": \"string\",\n \"phone\": \"string\",\n \"postal_code\": \"string\",\n \"region\": \"string\"\n },\n \"channel_order_id\": \"string\",\n \"created_at\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n },\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n }\n ],\n \"object\": \"string\",\n \"ordered_at\": \"string\",\n \"status\": \"string\",\n \"total_amount\": 0\n },\n {\n \"buyer\": {\n \"address_line1\": \"string\",\n \"address_line2\": \"string\",\n \"city\": \"string\",\n \"country\": \"string\",\n \"email\": \"string\",\n \"name\": \"string\",\n \"phone\": \"string\",\n \"postal_code\": \"string\",\n \"region\": \"string\"\n },\n \"channel_order_id\": \"string\",\n \"created_at\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n },\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n }\n ],\n \"object\": \"string\",\n \"ordered_at\": \"string\",\n \"status\": \"string\",\n \"total_amount\": 0\n }\n ],\n \"has_more\": false,\n \"next_cursor\": \"string\",\n \"object\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d2173b031b8ff8bc2b36b0ae5c249e6", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "024bc8d4bf664f8b2199b2a96d530c93", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "orders" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "limit", "value": "" }, { "key": "after", "value": "" }, { "key": "updated_after", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6f9e05bdfbcb0c90bb2c5b177c2da93f", "name": "Retrieve an order", "request": { "name": "Retrieve an order", "description": { "content": "Fetch a single order by its WTH `ord_*` identifier.", "type": "text/plain" }, "url": { "path": [ "v1", "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "6500cc1d9ebc4a223c40de00272dd1bf", "name": "An order.", "originalRequest": { "url": { "path": [ "v1", "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"buyer\": {\n \"address_line1\": \"string\",\n \"address_line2\": \"string\",\n \"city\": \"string\",\n \"country\": \"string\",\n \"email\": \"string\",\n \"name\": \"string\",\n \"phone\": \"string\",\n \"postal_code\": \"string\",\n \"region\": \"string\"\n },\n \"channel_order_id\": \"string\",\n \"created_at\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n },\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n }\n ],\n \"object\": \"string\",\n \"ordered_at\": \"string\",\n \"status\": \"string\",\n \"total_amount\": 0\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "77e89404163ea6de09257e11e901e39d", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8cf37f4f13c1909b30188330cb019fc1", "name": "Order not found.", "originalRequest": { "url": { "path": [ "v1", "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b246e3685836fa7ea1ff2ee52bbe3c26", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "orders", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "f0b59d762f35d16a0c3b478d483ca60e", "name": "Cancel an order", "request": { "name": "Cancel an order", "description": { "content": "Marks an order cancelled. Idempotent — replaying with the same `Idempotency-Key` returns the original response. Cancelling an already-cancelled order is a no-op.", "type": "text/plain" }, "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "b7bc5a79380639b28ca2a9e6cc9bb958", "name": "Order cancelled.", "originalRequest": { "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"buyer\": {\n \"address_line1\": \"string\",\n \"address_line2\": \"string\",\n \"city\": \"string\",\n \"country\": \"string\",\n \"email\": \"string\",\n \"name\": \"string\",\n \"phone\": \"string\",\n \"postal_code\": \"string\",\n \"region\": \"string\"\n },\n \"channel_order_id\": \"string\",\n \"created_at\": \"string\",\n \"currency\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"line_items\": [\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n },\n {\n \"external_id\": \"string\",\n \"quantity\": 0,\n \"sku\": \"string\",\n \"unit_amount\": 0\n }\n ],\n \"object\": \"string\",\n \"ordered_at\": \"string\",\n \"status\": \"string\",\n \"total_amount\": 0\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5ad2ea74df91cb989c2dc62324d5b6ec", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a9287f1bb4e0a97b92070cbc6eaaae11", "name": "Order not found.", "originalRequest": { "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9c62bb48c54048c25c0741b39f353e2d", "name": "Idempotency-key body mismatch.", "originalRequest": { "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2532ea4f7dd5b3f90d740ead3451ff2f", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "orders", ":id", "cancel" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "aabe76f1f4ec532b6a9928e5cc4bc865", "name": "Customers", "description": { "content": "Customer data forwarded from the dealer's site (single + bulk).", "type": "text/plain" }, "item": [ { "id": "ae29f3253e345e4b347d0c7f1562a46c", "name": "Upsert a customer", "request": { "name": "Upsert a customer", "description": { "content": "Creates or matches a single customer keyed on `external_id`. Idempotent — repeating the same payload returns the existing customer with `matched_existing: true`. Returns 201 when a new row is created and 200 when an existing row matched.", "type": "text/plain" }, "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "9b7c0602fd665867229dac71d3af8b80", "name": "Existing customer matched.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accepts_marketing\": false,\n \"created_at\": \"string\",\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"matched_existing\": false,\n \"name\": \"string\",\n \"object\": \"string\",\n \"phone\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7eacb142870ed64fabbaa22a1051da75", "name": "Customer created.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"accepts_marketing\": false,\n \"created_at\": \"string\",\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"matched_existing\": false,\n \"name\": \"string\",\n \"object\": \"string\",\n \"phone\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3dbc14339e84391279b3a8dc91c88e9d", "name": "Validation error.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "336220c4b6398ca02aa8ba7f6667b78b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b650a7936401c75d5626b62895be68b", "name": "Idempotency-key body mismatch.", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "01079975f75fc82cdca73a9727d895cd", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "customers" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fd155331758ad0b56a3795d47838b34d", "name": "Bulk upsert customers", "request": { "name": "Bulk upsert customers", "description": { "content": "Upserts up to 1000 customers in a single call. Each customer is processed independently; the response contains one entry per input customer in input order.", "type": "text/plain" }, "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "4c71844502020c1ed927ea505f4a9af0", "name": "Bulk upsert results.", "originalRequest": { "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"accepts_marketing\": false,\n \"created_at\": \"string\",\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"matched_existing\": false,\n \"name\": \"string\",\n \"object\": \"string\",\n \"phone\": \"string\"\n },\n {\n \"accepts_marketing\": false,\n \"created_at\": \"string\",\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"id\": \"string\",\n \"matched_existing\": false,\n \"name\": \"string\",\n \"object\": \"string\",\n \"phone\": \"string\"\n }\n ],\n \"object\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ee5d13e46ce0c5c0fa525ea894891db4", "name": "Validation error.", "originalRequest": { "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f4794215994326aed937091c0f91560c", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a18b3047330f0e19e75b1363b7b84d83", "name": "Idempotency-key body mismatch.", "originalRequest": { "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8cb6c94d8c49947f8f2f5c64bf2cab9", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "customers", "bulk" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"customers\": [\n {\n \"accepts_marketing\": false,\n \"email\": \"string\",\n \"external_id\": \"string\",\n \"metadata\": {\n \"key_0\": {}\n },\n \"name\": \"string\",\n \"phone\": \"string\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "0d79e001e3c052d6499c94d968745388", "name": "Test utilities", "description": { "content": "Smoke-test endpoints for verifying webhook wiring.", "type": "text/plain" }, "item": [ { "id": "16b24ee7ad4fbbfa01e18ed6d0629c0f", "name": "Trigger a test webhook", "request": { "name": "Trigger a test webhook", "description": { "content": "Fires an `integration.test_event` webhook to your configured endpoint. Useful for verifying your receiver works end-to-end. Idempotent — replays return the original delivery record.", "type": "text/plain" }, "url": { "path": [ "v1", "test", "webhook_ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] } }, "response": [ { "id": "0b694e0d2f82e6422a702e976a106cb2", "name": "Test event queued for delivery.", "originalRequest": { "url": { "path": [ "v1", "test", "webhook_ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"string\",\n \"object\": \"string\",\n \"type\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "32c86c098c1607c2723952cf2b95726b", "name": "Unauthorized", "originalRequest": { "url": { "path": [ "v1", "test", "webhook_ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19501a8a3fbfd4e9a4cc7c2aad7a8e0c", "name": "Idempotency-key body mismatch.", "originalRequest": { "url": { "path": [ "v1", "test", "webhook_ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a56dfa0606aafbb579ccc352b8ac93d4", "name": "Rate limited", "originalRequest": { "url": { "path": [ "v1", "test", "webhook_ping" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "(Required) ", "key": "idempotency-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"code\": \"string\",\n \"doc_url\": \"string\",\n \"message\": \"string\",\n \"param\": \"string\",\n \"request_id\": \"string\",\n \"type\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://watchtraderhub.com/api", "key": "baseUrl" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}" } ] }, "info": { "_postman_id": "a946caef331f5a387e16b123436d9019", "name": "WatchTraderHub Custom Integration API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Public REST API + outbound webhooks for connecting custom websites to WatchTraderHub. Bearer-token auth via API keys. Outbound webhooks signed with HMAC-SHA256 (Stripe-style).\n\nContact Support:\n Name: WatchTraderHub Support", "type": "text/plain" } } }