{"info":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","description":"<html><head></head><body><p>The Sora Merch API provides programmatic access to the product catalog and to order management.</p>\n<h2 id=\"authentication\">Authentication</h2>\n<p>Every request authenticates with an <code>Authorization: Bearer {key_id}.{secret}</code> header. The secret is<br>shown once, when the key is created in the client portal. Keys carry a permission of <code>read</code>,<br><code>write</code> or <code>read_write</code>, and may optionally be restricted to an IP allowlist configured in the<br>client portal.</p>\n<h2 id=\"errors\">Errors</h2>\n<p>A controlled error returns <code>{\"message\": \"...\", \"code\": \"CA-xxxx\"}</code>. A request-validation failure<br>returns <code>{\"message\": \"...\", \"errors\": {\"field\": [\"...\"]}}</code>, with no <code>code</code>.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Code</th>\n<th>HTTP</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>CA-1000</td>\n<td>500</td>\n<td>Unexpected server error.</td>\n</tr>\n<tr>\n<td>CA-1001</td>\n<td>401</td>\n<td>The <code>Authorization</code> header is missing.</td>\n</tr>\n<tr>\n<td>CA-1002</td>\n<td>401</td>\n<td>The <code>Authorization</code> header is present but empty.</td>\n</tr>\n<tr>\n<td>CA-1003</td>\n<td>401</td>\n<td>The API key is malformed, unknown or revoked.</td>\n</tr>\n<tr>\n<td>CA-1004</td>\n<td>403</td>\n<td>The key's permission (<code>read</code>/<code>write</code>) does not cover the request.</td>\n</tr>\n<tr>\n<td>CA-1005</td>\n<td>404</td>\n<td>The requested resource was not found.</td>\n</tr>\n<tr>\n<td>CA-1006</td>\n<td>404</td>\n<td>The product was not found or is not available to the account.</td>\n</tr>\n<tr>\n<td>CA-1007</td>\n<td>404</td>\n<td>No account was found for this key.</td>\n</tr>\n<tr>\n<td>CA-1008</td>\n<td>422</td>\n<td>The product exists but is not currently orderable.</td>\n</tr>\n<tr>\n<td>CA-1009</td>\n<td>500</td>\n<td>Order creation failed.</td>\n</tr>\n<tr>\n<td>CA-1010</td>\n<td>409</td>\n<td><code>order_number</code> and <code>additional_order_number</code> were already used together.</td>\n</tr>\n<tr>\n<td>CA-1011</td>\n<td>422</td>\n<td><code>country</code> is required on the request.</td>\n</tr>\n<tr>\n<td>CA-1012</td>\n<td>404</td>\n<td>The given country is not accessible to the account.</td>\n</tr>\n<tr>\n<td>CA-1014</td>\n<td>409</td>\n<td>The order's current status does not allow updating.</td>\n</tr>\n<tr>\n<td>CA-1015</td>\n<td>409</td>\n<td>The order's current status does not allow cancellation.</td>\n</tr>\n<tr>\n<td>CA-1016</td>\n<td>409</td>\n<td>Cancellation could not be processed.</td>\n</tr>\n<tr>\n<td>CA-1017</td>\n<td>422</td>\n<td>The recipient address could not be verified.</td>\n</tr>\n<tr>\n<td>CA-1018</td>\n<td>409</td>\n<td>Pricing is not available for this product on the account.</td>\n</tr>\n<tr>\n<td>CA-1020</td>\n<td>409</td>\n<td>The <code>price_id</code> does not match the product's current price.</td>\n</tr>\n<tr>\n<td>CA-1021</td>\n<td>422</td>\n<td>The country is not currently supported for order delivery.</td>\n</tr>\n<tr>\n<td>CA-1022</td>\n<td>429</td>\n<td>The rate limit was exceeded.</td>\n</tr>\n<tr>\n<td>CA-1023</td>\n<td>405</td>\n<td>The HTTP method is not supported for this endpoint.</td>\n</tr>\n<tr>\n<td>CA-1024</td>\n<td>403</td>\n<td>The requesting IP address is not on the key's configured allowlist.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"rate-limits\">Rate limits</h2>\n<p>60 requests per minute per API key. Exceeding it returns <code>429 CA-1022</code> with a <code>Retry-After</code> header.</p>\n<h2 id=\"pagination\">Pagination</h2>\n<p>List endpoints return a paginated envelope (<code>data</code>, <code>links</code>, <code>meta</code>) and accept <code>per_page</code><br>(1-100, default 15) and <code>page</code> query parameters.</p>\n<h2 id=\"order-status\">Order status</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Status</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>processing</code></td>\n<td>The order has been received and is being reviewed before it is accepted.</td>\n</tr>\n<tr>\n<td><code>on_hold</code></td>\n<td>The order requires attention before it can proceed; see <code>hold_reason</code> for the cause.</td>\n</tr>\n<tr>\n<td><code>accepted</code></td>\n<td>The order has been accepted and can still be cancelled.</td>\n</tr>\n<tr>\n<td><code>ordered</code></td>\n<td>The order has been placed with the supplier. It can no longer be cancelled or updated.</td>\n</tr>\n<tr>\n<td><code>shipped</code></td>\n<td>The order has been dispatched. <code>tracking</code> carries the carrier and tracking number once recorded.</td>\n</tr>\n<tr>\n<td><code>returned</code></td>\n<td>The order was delivered and has since been returned.</td>\n</tr>\n<tr>\n<td><code>replaced</code></td>\n<td>The order was replaced with a new order.</td>\n</tr>\n<tr>\n<td><code>cancelled</code></td>\n<td>The order was cancelled and will not be fulfilled.</td>\n</tr>\n<tr>\n<td><code>invoiced</code></td>\n<td>The final status of a fulfilled order. The order has been invoiced.</td>\n</tr>\n</tbody>\n</table>\n</div><p>Orders progress from <code>processing</code>/<code>on_hold</code> through <code>accepted</code>, <code>ordered</code> and <code>shipped</code> to<br><code>invoiced</code>, with <code>cancelled</code>, <code>returned</code> or <code>replaced</code> reachable along the way.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"30983649","collectionId":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","publishedId":"2sBYB4Mmy6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-09-30T10:03:12.000Z"},"item":[{"name":"products","item":[{"name":"List all products","id":"0b9a8ddc-2cf4-48b3-8477-179defeecd51","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/products?country=JPN","description":"<p>Returns a paginated list of the products currently orderable by the account in a\ngiven country. Catalog responses may be served from a cache for up to 5 minutes.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["products"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[{"disabled":true,"description":{"content":"<p>Case-insensitive substring match against product name, SKU and product id.</p>\n","type":"text/plain"},"key":"search","value":"string"},{"disabled":true,"description":{"content":"<p>Exact match against a brand's id, from List all brands or a product's <code>brand.id</code>.</p>\n","type":"text/plain"},"key":"brand_id","value":"string"},{"disabled":true,"description":{"content":"<p>Exact match against a category, subcategory or subsubcategory id, from Retrieve the category tree or a product's <code>category.id</code>/<code>subcategory.id</code>/<code>subsubcategory.id</code>.</p>\n","type":"text/plain"},"key":"category_id","value":"string"},{"disabled":true,"description":{"content":"<p>Results per page. Defaults to 15.</p>\n","type":"text/plain"},"key":"per_page","value":""},{"disabled":true,"description":{"content":"<p>Page number.</p>\n","type":"text/plain"},"key":"page","value":"1"},{"key":"country","value":"JPN"}],"variable":[]}},"response":[{"id":"8a52f8cf-ac69-49db-95de-2d3fb106eb92","name":"A page of products, in the standard paginated envelope (`data`, `links`, `meta`).","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products"],"query":[{"key":"search","value":"string","description":"Case-insensitive substring match against product name, SKU and product id.","disabled":true},{"key":"brand_id","value":"string","description":"Exact match against a brand's id, from List all brands or a product's `brand.id`.","disabled":true},{"key":"category_id","value":"string","description":"Exact match against a category, subcategory or subsubcategory id, from Retrieve the category tree or a product's `category.id`/`subcategory.id`/`subsubcategory.id`.","disabled":true},{"key":"per_page","value":"","description":"Results per page. Defaults to 15.","disabled":true},{"key":"page","value":"1","description":"Page number.","disabled":true},{"key":"country","value":"JPN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": [\n    {\n      \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n      \"product_id\": \"SBX-ACTIVE\",\n      \"sku\": \"SBX-ACTIVE\",\n      \"availability\": \"available\",\n      \"name_en\": \"Sandbox Product SBX-ACTIVE\",\n      \"name_native\": null,\n      \"description_en\": null,\n      \"description_native\": null,\n      \"thumbnail\": null,\n      \"brand\": {\n        \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e99\",\n        \"name\": \"Sandbox Brand\"\n      },\n      \"category\": {\n        \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e9a\",\n        \"name\": \"Sandbox Category\"\n      },\n      \"subcategory\": null,\n      \"subsubcategory\": null,\n      \"pricing\": {\n        \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n        \"price_ex_vat\": 80,\n        \"price_w_vat\": 88,\n        \"shipping_ex_vat\": 5,\n        \"shipping_w_vat\": 5,\n        \"msrp_ex_vat\": 100,\n        \"msrp_w_vat\": 110,\n        \"currency\": \"JPY\",\n        \"currency_symbol\": \"¥\"\n      }\n    }\n  ],\n  \"links\": {\n    \"first\": \"https://dev.api.sorarewards.com/api/v1/sr/products?page=1\",\n    \"last\": \"https://dev.api.sorarewards.com/api/v1/sr/products?page=1\",\n    \"prev\": null,\n    \"next\": null\n  },\n  \"meta\": {\n    \"current_page\": 1,\n    \"from\": 1,\n    \"last_page\": 1,\n    \"path\": \"https://dev.api.sorarewards.com/api/v1/sr/products\",\n    \"per_page\": 15,\n    \"to\": 1,\n    \"total\": 1,\n    \"links\": [\n      {\n        \"url\": null,\n        \"label\": \"&laquo; Previous\",\n        \"page\": null,\n        \"active\": false\n      },\n      {\n        \"url\": \"https://dev.api.sorarewards.com/api/v1/sr/products?page=1\",\n        \"label\": \"1\",\n        \"page\": 1,\n        \"active\": true\n      },\n      {\n        \"url\": null,\n        \"label\": \"Next &raquo;\",\n        \"page\": null,\n        \"active\": false\n      }\n    ]\n  }\n}"},{"id":"a565bc21-7bbe-4217-81ac-b053f79585db","name":"The requested resource is not available.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products"],"query":[{"key":"search","value":"string","description":"Case-insensitive substring match against product name, SKU and product id.","disabled":true},{"key":"brand_id","value":"string","description":"Exact match against a brand's id, from List all brands or a product's `brand.id`.","disabled":true},{"key":"category_id","value":"string","description":"Exact match against a category, subcategory or subsubcategory id, from Retrieve the category tree or a product's `category.id`/`subcategory.id`/`subsubcategory.id`.","disabled":true},{"key":"per_page","value":"","description":"Results per page. Defaults to 15.","disabled":true},{"key":"page","value":"1","description":"Page number.","disabled":true},{"key":"country","value":"JPN"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"This country is not accessible for your account.\",\n  \"code\": \"CA-1012\"\n}"},{"id":"9c3f17e2-5c71-49c9-9cc5-3ca081259f86","name":"A request-validation failure ({message, errors}), or country_required ({message, code}).","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products?country=","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products"],"query":[{"key":"search","value":"string","description":"Case-insensitive substring match against product name, SKU and product id.","disabled":true},{"key":"brand_id","value":"string","description":"Exact match against a brand's id, from List all brands or a product's `brand.id`.","disabled":true},{"key":"category_id","value":"string","description":"Exact match against a category, subcategory or subsubcategory id, from Retrieve the category tree or a product's `category.id`/`subcategory.id`/`subsubcategory.id`.","disabled":true},{"key":"per_page","value":"","description":"Results per page. Defaults to 15.","disabled":true},{"key":"page","value":"1","description":"Page number.","disabled":true},{"key":"country","value":""}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Specify the country this order is for.\",\n  \"code\": \"CA-1011\"\n}"}],"_postman_id":"0b9a8ddc-2cf4-48b3-8477-179defeecd51"},{"name":"Retrieve a product","id":"e9a06a07-9708-4782-b20b-46e3e703ec18","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/products/:id?country=JPN","description":"<p>Returns the product if a valid id or product_id was provided, and the product is\ncurrently orderable by the account in the given country.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["products",":id"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[{"key":"country","value":"JPN"}],"variable":[{"type":"any","value":"string","key":"id"}]}},"response":[{"id":"f03e114e-7d88-49be-841d-78979ebc3916","name":"`Product`","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products/:id?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products",":id"],"query":[{"key":"country","value":"JPN"}],"variable":[{"key":"id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n    \"product_id\": \"SBX-ACTIVE\",\n    \"sku\": \"SBX-ACTIVE\",\n    \"availability\": \"available\",\n    \"name_en\": \"Sandbox Product SBX-ACTIVE\",\n    \"name_native\": null,\n    \"description_en\": null,\n    \"description_native\": null,\n    \"thumbnail\": null,\n    \"brand\": {\n      \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e99\",\n      \"name\": \"Sandbox Brand\"\n    },\n    \"category\": {\n      \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e9a\",\n      \"name\": \"Sandbox Category\"\n    },\n    \"subcategory\": null,\n    \"subsubcategory\": null,\n    \"pricing\": {\n      \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n      \"price_ex_vat\": 80,\n      \"price_w_vat\": 88,\n      \"shipping_ex_vat\": 5,\n      \"shipping_w_vat\": 5,\n      \"msrp_ex_vat\": 100,\n      \"msrp_w_vat\": 110,\n      \"currency\": \"JPY\",\n      \"currency_symbol\": \"¥\"\n    }\n  }\n}"},{"id":"ee7cc24e-177d-4ab2-8f81-59891228bcec","name":"The requested resource is not available.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products/:id?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products",":id"],"query":[{"key":"country","value":"JPN"}],"variable":[{"key":"id","value":"string"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Product not found or not available to your account.\",\n  \"code\": \"CA-1006\"\n}"},{"id":"42df5af6-6498-40dc-8dbb-053e7a5b2613","name":"country is missing.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/products/:id?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["products",":id"],"query":[{"key":"country","value":"JPN"}],"variable":[{"key":"id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Specify the country this order is for.\",\n  \"code\": \"CA-1011\"\n}"}],"_postman_id":"e9a06a07-9708-4782-b20b-46e3e703ec18"}],"id":"29137fd9-60cb-4705-9f50-add20474b1ca","_postman_id":"29137fd9-60cb-4705-9f50-add20474b1ca","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}}},{"name":"brands","item":[{"name":"List all brands","id":"9944c893-0460-4f41-8044-8289b0d144c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/brands?country=JPN","description":"<p>Returns the brands with at least one product currently orderable by the account\nin a given country, sorted by name.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["brands"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[{"key":"country","value":"JPN"}],"variable":[]}},"response":[{"id":"b6b628bd-5c49-4e5f-b5e6-38cb09905a04","name":"The brands with at least one orderable product for this client and country.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/brands?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["brands"],"query":[{"key":"country","value":"JPN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n  {\n    \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e99\",\n    \"name\": \"Sandbox Brand\"\n  }\n]"},{"id":"5e03a9cd-4149-41c9-bb6c-e03ba8a3d315","name":"The requested resource is not available.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/brands?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["brands"],"query":[{"key":"country","value":"JPN"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"This country is not accessible for your account.\",\n  \"code\": \"CA-1012\"\n}"},{"id":"472cd280-8b78-4a3c-b8e5-607b66ebbe5b","name":"country is missing.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/brands?country=","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["brands"],"query":[{"key":"country","value":""}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Specify the country this order is for.\",\n  \"code\": \"CA-1011\"\n}"}],"_postman_id":"9944c893-0460-4f41-8044-8289b0d144c1"}],"id":"0fa69e22-06fd-437a-bcda-9d8a7d311cc4","_postman_id":"0fa69e22-06fd-437a-bcda-9d8a7d311cc4","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}}},{"name":"categories","item":[{"name":"Retrieve the category tree","id":"1491c786-bd09-40ed-836a-b8ff24d3951f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/categories?country=JPN","description":"<p>Returns the category tree (category, subcategory, subsubcategory) pruned to nodes\nwith at least one product currently orderable by the account in a given country,\nsorted by name at each level.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["categories"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[{"key":"country","value":"JPN"}],"variable":[]}},"response":[{"id":"e430b9d5-44f1-4e90-a85b-45c4f582b6ca","name":"The category tree pruned to nodes with at least one orderable product for this client and country.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/categories?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["categories"],"query":[{"key":"country","value":"JPN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n  {\n    \"id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e9a\",\n    \"name\": \"Sandbox Category\",\n    \"subcategories\": []\n  }\n]"},{"id":"3c445345-aa96-45a3-96d9-3740c6fa9706","name":"The requested resource is not available.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/categories?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["categories"],"query":[{"key":"country","value":"JPN"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"This country is not accessible for your account.\",\n  \"code\": \"CA-1012\"\n}"},{"id":"fb567ac9-d4cb-4a6e-b425-c5c05832306a","name":"country is missing.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/categories?country=JPN","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["categories"],"query":[{"key":"country","value":"JPN"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Specify the country this order is for.\",\n  \"code\": \"CA-1011\"\n}"}],"_postman_id":"1491c786-bd09-40ed-836a-b8ff24d3951f"}],"id":"67ea2d60-8976-4eb8-abaf-f3085fa0797a","_postman_id":"67ea2d60-8976-4eb8-abaf-f3085fa0797a","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}}},{"name":"orders","item":[{"name":"List all orders","id":"e98a37bb-f33a-4ba7-b95a-f598ebadb42e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/orders","description":"<p>Returns a paginated list of orders for the account, most recent first.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["orders"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[{"disabled":true,"description":{"content":"<p>Filters orders by status. When omitted, returns active orders: <code>processing</code>, <code>on_hold</code>, <code>accepted</code>, <code>ordered</code> and <code>shipped</code>.</p>\n","type":"text/plain"},"key":"status","value":""},{"disabled":true,"description":{"content":"<p>Exact match against the account's own reference for the order.</p>\n","type":"text/plain"},"key":"order_number","value":"string"},{"disabled":true,"description":{"content":"<p>Order date range start, inclusive.</p>\n","type":"text/plain"},"key":"from_date","value":"1988-06-17T12:07:07.487Z"},{"disabled":true,"description":{"content":"<p>Order date range end, inclusive.</p>\n","type":"text/plain"},"key":"to_date","value":"1988-06-17T12:07:07.487Z"},{"disabled":true,"description":{"content":"<p>Results per page. Defaults to 15.</p>\n","type":"text/plain"},"key":"per_page","value":""},{"disabled":true,"description":{"content":"<p>Page number.</p>\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"9132d736-d6a7-451d-865b-5c3572b728f3","name":"A page of orders, in the standard paginated envelope (`data`, `links`, `meta`).","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders"],"query":[{"description":"Filters orders by status. When omitted, returns active orders: `processing`, `on_hold`, `accepted`, `ordered` and `shipped`.","key":"status","value":"","disabled":true},{"description":"Exact match against the account's own reference for the order.","key":"order_number","value":"string","disabled":true},{"description":"Order date range start, inclusive.","key":"from_date","value":"1988-06-17T12:07:07.487Z","disabled":true},{"description":"Order date range end, inclusive.","key":"to_date","value":"1988-06-17T12:07:07.487Z","disabled":true},{"description":"Results per page. Defaults to 15.","key":"per_page","value":"","disabled":true},{"description":"Page number.","key":"page","value":"1","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": [\n    {\n      \"id\": \"01a0a82e-4713-735a-94af-ca9b27962544\",\n      \"order_number\": \"SANDBOX-LIVE-DEMO-1\",\n      \"additional_order_number\": null,\n      \"order_date\": \"2026-09-15\",\n      \"status\": \"accepted\",\n      \"country_code\": \"JPN\",\n      \"recipient\": {\n        \"preferred_name\": null,\n        \"first_name\": \"FirstName\",\n        \"last_name\": \"LastName\",\n        \"phone\": null,\n        \"email\": null,\n        \"zip_code\": \"150-0002\",\n        \"shipping_address_1\": \"1-2-3 Shibuya\",\n        \"shipping_address_2\": null,\n        \"shipping_address_3\": null\n      },\n      \"item\": {\n        \"name\": \"Sandbox Product SBX-ACTIVE\",\n        \"sku\": \"SBX-ACTIVE\",\n        \"product_id\": \"SBX-ACTIVE\",\n        \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n        \"quantity\": 1,\n        \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n        \"price_ex_vat\": 80,\n        \"price_w_vat\": 88,\n        \"shipping_ex_vat\": 5,\n        \"shipping_w_vat\": 5\n      },\n      \"hold_reason\": null,\n      \"tracking\": null,\n      \"created_at\": \"2026-09-15T02:10:00.000000Z\",\n      \"updated_at\": \"2026-09-15T02:10:00.000000Z\"\n    }\n  ],\n  \"links\": {\n    \"first\": \"https://dev.api.sorarewards.com/api/v1/sr/orders?page=1\",\n    \"last\": \"https://dev.api.sorarewards.com/api/v1/sr/orders?page=1\",\n    \"prev\": null,\n    \"next\": null\n  },\n  \"meta\": {\n    \"current_page\": 1,\n    \"from\": 1,\n    \"last_page\": 1,\n    \"path\": \"https://dev.api.sorarewards.com/api/v1/sr/orders\",\n    \"per_page\": 15,\n    \"to\": 1,\n    \"total\": 1,\n    \"links\": [\n      {\n        \"url\": null,\n        \"label\": \"&laquo; Previous\",\n        \"page\": null,\n        \"active\": false\n      },\n      {\n        \"url\": \"https://dev.api.sorarewards.com/api/v1/sr/orders?page=1\",\n        \"label\": \"1\",\n        \"page\": 1,\n        \"active\": true\n      },\n      {\n        \"url\": null,\n        \"label\": \"Next &raquo;\",\n        \"page\": null,\n        \"active\": false\n      }\n    ]\n  }\n}"},{"id":"2f34f0d7-344f-40e0-9b10-32f7613c73d1","name":"Invalid status, or an unparseable from_date/to_date.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders"],"query":[{"description":"Filters orders by status. When omitted, returns active orders: `processing`, `on_hold`, `accepted`, `ordered` and `shipped`.","key":"status","value":"","disabled":true},{"description":"Exact match against the account's own reference for the order.","key":"order_number","value":"string","disabled":true},{"description":"Order date range start, inclusive.","key":"from_date","value":"1988-06-17T12:07:07.487Z","disabled":true},{"description":"Order date range end, inclusive.","key":"to_date","value":"1988-06-17T12:07:07.487Z","disabled":true},{"description":"Results per page. Defaults to 15.","key":"per_page","value":"","disabled":true},{"description":"Page number.","key":"page","value":"1","disabled":true}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"string\",\n  \"errors\": {\n    \"key_0\": [\n      \"string\",\n      \"string\"\n    ],\n    \"key_1\": [\n      \"string\",\n      \"string\"\n    ]\n  }\n}"}],"_postman_id":"e98a37bb-f33a-4ba7-b95a-f598ebadb42e"},{"name":"Create an order","id":"cc825af4-2612-4f2d-97c1-317973a03ef0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders","description":"<p>Creates an order for one product line, priced for the account at creation time.</p>\n<p>Returns the created order.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["orders"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[],"variable":[]}},"response":[{"id":"738efd61-55dd-4cc7-9701-6cd09dd8b2a2","name":"200","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{}"},{"id":"a8903782-0cd5-451b-bf89-b12fbb045116","name":"The created order.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"id\": \"01a0ad87-929c-7343-8753-710e832d7f5c\",\n    \"order_number\": \"CAP-CANCEL-OK-1\",\n    \"additional_order_number\": null,\n    \"order_date\": \"2026-09-15\",\n    \"status\": \"accepted\",\n    \"country_code\": \"JPN\",\n    \"recipient\": {\n      \"preferred_name\": null,\n      \"first_name\": \"FirstName\",\n      \"last_name\": \"LastName\",\n      \"phone\": null,\n      \"email\": null,\n      \"zip_code\": \"150-0002\",\n      \"shipping_address_1\": \"1-2-3 Shibuya\",\n      \"shipping_address_2\": null,\n      \"shipping_address_3\": null\n    },\n    \"item\": {\n      \"name\": \"Sandbox Product SBX-ACTIVE\",\n      \"sku\": \"SBX-ACTIVE\",\n      \"product_id\": \"SBX-ACTIVE\",\n      \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n      \"quantity\": 1,\n      \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n      \"price_ex_vat\": 80,\n      \"price_w_vat\": 88,\n      \"shipping_ex_vat\": 5,\n      \"shipping_w_vat\": 5\n    },\n    \"hold_reason\": null,\n    \"tracking\": null,\n    \"created_at\": \"2026-09-15T02:10:00.000000Z\",\n    \"updated_at\": \"2026-09-15T02:10:00.000000Z\"\n  }\n}"},{"id":"d03d212c-7bb9-4a44-8c16-15e734cc323e","name":"The requested resource is not available.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Product not found or not available to your account.\",\n  \"code\": \"CA-1006\"\n}"},{"id":"c5e80eec-c686-455d-952b-f77bd31cb74a","name":"The request conflicts with an existing order.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Order number already processed.\",\n  \"code\": \"CA-1010\"\n}"},{"id":"f809d66f-8105-46a1-bb87-1d85ad9366c3","name":"A request-validation failure ({message, errors}), or the order cannot be created for the given product, address or country ({message, code}).","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"The country code field is required.\",\n  \"errors\": {\n    \"country_code\": [\n      \"The country code field is required.\"\n    ]\n  }\n}"},{"id":"d0ebce4e-8ee7-4c90-ad35-02f655ff8e85","name":"Order creation failed.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"country_code\": \"JPN\",\n  \"order_number\": \"CAP-CANCEL-OK-1\",\n  \"order_date\": \"2026-09-16\",\n  \"product_id\": \"SBX-ACTIVE\",\n  \"quantity\": 1,\n  \"recipient_zip_code\": \"1500002\",\n  \"recipient_first_name\": \"FirstName\",\n  \"recipient_last_name\": \"LastName\",\n  \"recipient_shipping_address_1\": \"1-2-3 Shibuya\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"cc825af4-2612-4f2d-97c1-317973a03ef0"},{"name":"Cancel an order","id":"75ea9261-3fe5-4a6a-bcb1-1e8ea10d6fe3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","description":"<p>Cancels an order that has not yet been placed with the supplier. Available while\nstatus is processing, on_hold or accepted; once ordered, cancellation returns 409\nCA-1015.</p>\n<p>Returns the cancelled order.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["orders",":order","cancel"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[],"variable":[{"id":"de8925e4-9939-4abe-91cf-572a442583c4","description":{"content":"<p>The order's id.</p>\n","type":"text/plain"},"type":"any","value":"string","key":"order"}]}},"response":[{"id":"820cfc71-4635-4c58-8d06-5add7b3d10fb","name":"The cancelled order.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order","cancel"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"id\": \"01a0ad87-929c-7343-8753-710e832d7f5c\",\n    \"order_number\": \"CAP-CANCEL-OK-1\",\n    \"additional_order_number\": null,\n    \"order_date\": \"2026-09-15\",\n    \"status\": \"cancelled\",\n    \"country_code\": \"JPN\",\n    \"recipient\": {\n      \"preferred_name\": null,\n      \"first_name\": \"FirstName\",\n      \"last_name\": \"LastName\",\n      \"phone\": null,\n      \"email\": null,\n      \"zip_code\": \"150-0002\",\n      \"shipping_address_1\": \"1-2-3 Shibuya\",\n      \"shipping_address_2\": null,\n      \"shipping_address_3\": null\n    },\n    \"item\": {\n      \"name\": \"Sandbox Product SBX-ACTIVE\",\n      \"sku\": \"SBX-ACTIVE\",\n      \"product_id\": \"SBX-ACTIVE\",\n      \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n      \"quantity\": 1,\n      \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n      \"price_ex_vat\": 80,\n      \"price_w_vat\": 88,\n      \"shipping_ex_vat\": 5,\n      \"shipping_w_vat\": 5\n    },\n    \"hold_reason\": null,\n    \"tracking\": null,\n    \"created_at\": \"2026-09-15T02:10:00.000000Z\",\n    \"updated_at\": \"2026-09-15T02:10:00.000000Z\"\n  }\n}"},{"id":"f1883307-0ec1-4127-b060-6f49437d0102","name":"The key does not have permission for this request, or the requesting IP is not on the key's allowlist.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order","cancel"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Forbidden. Insufficient permissions.\",\n  \"code\": \"CA-1004\"\n}"},{"id":"e33f788a-d3b1-4934-8451-c965b9bc8aee","name":"The requested resource is not available.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order","cancel"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Resource not found.\",\n  \"code\": \"CA-1005\"\n}"},{"id":"a03163d9-5915-4d2f-af09-6d6230dfdcea","name":"The order cannot be cancelled.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order","cancel"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"This order can no longer be cancelled.\",\n  \"code\": \"CA-1015\"\n}"},{"id":"5cdf363a-cd79-4dd6-8faf-4a852a17f745","name":"The optional reason exceeds 1000 characters.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"reason\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order/cancel","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order","cancel"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"The reason field must not be greater than 1000 characters.\",\n  \"errors\": {\n    \"reason\": [\n      \"The reason field must not be greater than 1000 characters.\"\n    ]\n  }\n}"}],"_postman_id":"75ea9261-3fe5-4a6a-bcb1-1e8ea10d6fe3"},{"name":"Retrieve an order","id":"81b4e53b-61c7-44ca-8b78-d5ef62841605","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","description":"<p>Returns the order if a valid identifier was provided.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["orders",":order"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[],"variable":[{"id":"1483befb-6d6f-4eb5-aaff-a60707f0a61f","description":{"content":"<p>The order's id.</p>\n","type":"text/plain"},"type":"any","value":"string","key":"order"}]}},"response":[{"id":"d25d6929-55aa-43c5-b124-440b7e41eef9","name":"`Order`","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"id\": \"01a0a82e-4713-735a-94af-ca9b27962544\",\n    \"order_number\": \"SANDBOX-LIVE-DEMO-1\",\n    \"additional_order_number\": null,\n    \"order_date\": \"2026-09-15\",\n    \"status\": \"accepted\",\n    \"country_code\": \"JPN\",\n    \"recipient\": {\n      \"preferred_name\": null,\n      \"first_name\": \"FirstName\",\n      \"last_name\": \"LastName\",\n      \"phone\": null,\n      \"email\": null,\n      \"zip_code\": \"150-0002\",\n      \"shipping_address_1\": \"1-2-3 Shibuya\",\n      \"shipping_address_2\": null,\n      \"shipping_address_3\": null\n    },\n    \"item\": {\n      \"name\": \"Sandbox Product SBX-ACTIVE\",\n      \"sku\": \"SBX-ACTIVE\",\n      \"product_id\": \"SBX-ACTIVE\",\n      \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n      \"quantity\": 1,\n      \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n      \"price_ex_vat\": 80,\n      \"price_w_vat\": 88,\n      \"shipping_ex_vat\": 5,\n      \"shipping_w_vat\": 5\n    },\n    \"hold_reason\": null,\n    \"tracking\": null,\n    \"created_at\": \"2026-09-15T02:10:00.000000Z\",\n    \"updated_at\": \"2026-09-15T02:10:00.000000Z\"\n  }\n}"},{"id":"92116bc3-94d9-47e1-b2fa-242c609bfe3b","name":"The requested resource is not available.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Resource not found.\",\n  \"code\": \"CA-1005\"\n}"}],"_postman_id":"81b4e53b-61c7-44ca-8b78-d5ef62841605"},{"name":"Update an order","id":"1263daec-9cbf-4a72-aa48-c40dd3711a7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","description":"<p>Updates an order that has not yet been processed with the supplier. Available\nwhile status is processing or on_hold, and re-evaluates the order's hold_reason\non success.</p>\n<p>Returns the updated order.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}},"urlObject":{"path":["orders",":order"],"host":["https://dev.api.sorarewards.com/api/v1/sr"],"query":[],"variable":[{"id":"684875e2-6516-43cd-a742-3d7b7f00a8d5","description":{"content":"<p>The order's id.</p>\n","type":"text/plain"},"type":"any","value":"string","key":"order"}]}},"response":[{"id":"e093702f-1fff-470a-83d6-5f7b18fc51cb","name":"The updated order.","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"data\": {\n    \"id\": \"01a0ad86-41ba-725e-8cf8-f2dd8427c85b\",\n    \"order_number\": \"CAP-UPD-1\",\n    \"additional_order_number\": null,\n    \"order_date\": \"2026-09-15\",\n    \"status\": \"accepted\",\n    \"country_code\": \"JPN\",\n    \"recipient\": {\n      \"preferred_name\": null,\n      \"first_name\": \"FirstName\",\n      \"last_name\": \"LastName\",\n      \"phone\": null,\n      \"email\": null,\n      \"zip_code\": \"150-0002\",\n      \"shipping_address_1\": \"1-2-3 Shibuya\",\n      \"shipping_address_2\": null,\n      \"shipping_address_3\": null\n    },\n    \"item\": {\n      \"name\": \"Sandbox Product SBX-ACTIVE\",\n      \"sku\": \"SBX-ACTIVE\",\n      \"product_id\": \"SBX-ACTIVE\",\n      \"id\": \"3127119f-93c5-4e48-bb80-f59b02146f21\",\n      \"quantity\": 1,\n      \"price_id\": \"01a0a82d-e844-7338-aef6-77ff99cd4e98\",\n      \"price_ex_vat\": 80,\n      \"price_w_vat\": 88,\n      \"shipping_ex_vat\": 5,\n      \"shipping_w_vat\": 5\n    },\n    \"hold_reason\": null,\n    \"tracking\": null,\n    \"created_at\": \"2026-09-15T02:10:00.000000Z\",\n    \"updated_at\": \"2026-09-15T02:10:00.000000Z\"\n  }\n}"},{"id":"2d798471-e72a-4767-adb0-5c5e5fafc988","name":"The key does not have permission for this request, or the requesting IP is not on the key's allowlist.","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Forbidden. Insufficient permissions.\",\n  \"code\": \"CA-1004\"\n}"},{"id":"0def42b6-2665-4d56-9aaf-f23163059130","name":"The requested resource is not available.","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Resource not found.\",\n  \"code\": \"CA-1005\"\n}"},{"id":"8a151e08-9b47-4a15-95d1-3bc664034ade","name":"The order cannot be updated in its current status.","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"This order can no longer be changed.\",\n  \"code\": \"CA-1014\"\n}"},{"id":"1ba30a6a-9134-474d-aac7-cc5726fb8419","name":"A request-validation failure ({message, errors}), or the address could not be verified ({message, code}).","originalRequest":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"recipient_zip_code\": \"1500002\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://dev.api.sorarewards.com/api/v1/sr/orders/:order","host":["https://dev.api.sorarewards.com/api/v1/sr"],"path":["orders",":order"],"variable":[{"key":"order","value":"string","description":"The order's id."}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"message\": \"Invalid Zipcode or Address.\",\n  \"code\": \"CA-1017\"\n}"}],"_postman_id":"1263daec-9cbf-4a72-aa48-c40dd3711a7b"}],"id":"60461139-417f-4b26-a5bc-10de5a825b99","_postman_id":"60461139-417f-4b26-a5bc-10de5a825b99","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":true,"source":{"_postman_id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","id":"8ae97b50-1be9-41aa-a2b7-2c67eed643e1","name":"Sora Merch API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]}},"variable":[{"key":"baseUrl","value":"https://dev.api.sorarewards.com/api/v1/sr"}]}